codex-overleaf-link 1.9.6 → 1.9.8

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.6-blue" alt="version">
+    <img src="https://img.shields.io/badge/version-1.9.8-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.6 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.6/install.sh)"
+CODEX_OVERLEAF_REF=v1.9.8 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.8/install.sh)"
 ```
 
 Windows PowerShell:
 
 ```powershell
-iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.6/install.ps1 -OutFile install.ps1
-$env:CODEX_OVERLEAF_REF='v1.9.6'
+iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.8/install.ps1 -OutFile install.ps1
+$env:CODEX_OVERLEAF_REF='v1.9.8'
 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.6 -- install-managed
+npm exec --yes codex-overleaf-link@1.9.8 -- 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.6 -- install-managed` |
-| Diagnose | `npm exec --yes codex-overleaf-link@1.9.6 -- doctor` |
-| Uninstall | `npm exec --yes codex-overleaf-link@1.9.6 -- uninstall-managed` |
+| Install / update | `npm exec --yes codex-overleaf-link@1.9.8 -- install-managed` |
+| Diagnose | `npm exec --yes codex-overleaf-link@1.9.8 -- doctor` |
+| Uninstall | `npm exec --yes codex-overleaf-link@1.9.8 -- 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.6 GitHub Release contains:
+The v1.9.8 GitHub Release contains:
 
-- `codex-overleaf-link-extension-v1.9.6.zip`: loadable Chrome extension package for manual unpacked installation.
-- `codex-overleaf-native-host-v1.9.6.tar.gz`: native host runtime files used by the installer and release verification.
-- `codex-overleaf-link-1.9.6.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.6` when run directly from the release artifact.
-- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.9.6` when run directly from the release artifact.
+- `codex-overleaf-link-extension-v1.9.8.zip`: loadable Chrome extension package for manual unpacked installation.
+- `codex-overleaf-native-host-v1.9.8.tar.gz`: native host runtime files used by the installer and release verification.
+- `codex-overleaf-link-1.9.8.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.8` when run directly from the release artifact.
+- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.9.8` 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.6 GitHub Release contains:
 Remove the native host (use `--browser chromium` on Linux Chromium):
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.6 -- uninstall-managed
+npm exec --yes codex-overleaf-link@1.9.8 -- 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.6 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.6/install.sh)" -- --browser chromium
+CODEX_OVERLEAF_REF=v1.9.8 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.8/install.sh)" -- --browser chromium
 ```
 
 Linux Chromium uninstall:
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.6 -- uninstall-managed --browser chromium
+npm exec --yes codex-overleaf-link@1.9.8 -- 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.6 -- install-managed
+npm exec --yes codex-overleaf-link@1.9.8 -- 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.6 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.6 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.6 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.6 -- install-managed --browser chromium` |
-| Uninstall command | `npm exec --yes codex-overleaf-link@1.9.6 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.6 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.6 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.6 -- uninstall-managed --browser chromium` |
+| Installer/update command | `npm exec --yes codex-overleaf-link@1.9.8 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.8 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.8 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.8 -- install-managed --browser chromium` |
+| Uninstall command | `npm exec --yes codex-overleaf-link@1.9.8 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.8 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.8 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.8 -- 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.6 -- install-managed
+npm exec --yes codex-overleaf-link@1.9.8 -- 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.6 -- install-native
+npm exec --yes codex-overleaf-link@1.9.8 -- install-native
 ```
 
 Legacy native-only installations can be removed with:
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.6 -- uninstall-native
+npm exec --yes codex-overleaf-link@1.9.8 -- uninstall-native
 ```

package/extension/bootstrap/background.js

@@ -6,10 +6,15 @@ const UPDATE_STATE_KEY = 'codex-overleaf-managed-update-state-v1';
 const UPDATE_RELOAD_TABS_KEY = 'codex-overleaf-managed-update-tabs-v1';
 const CHECK_ALARM = 'codex-overleaf-stable-update-check';
 const IDLE_ALARM = 'codex-overleaf-staged-update-idle';
-const OVERLEAF_MATCHES = [
+const OVERLEAF_EDITOR_MATCHES = [
   'https://www.overleaf.com/project/*',
   'https://overleaf.com/project/*'
 ];
+const OVERLEAF_MATCHES = [
+  'https://www.overleaf.com/project',
+  'https://overleaf.com/project',
+  ...OVERLEAF_EDITOR_MATCHES
+];
 const APPLYING_STATES = new Set(['applying', 'awaiting_health', 'rolling_back']);
 
 let runtimeLoadError = null;
@@ -195,7 +200,7 @@ async function tryApplyStagedUpdate() {
   if (Number(state.postponeUntil || 0) > Date.now()) {
     return state;
   }
-  const tabs = await chrome.tabs.query({ url: OVERLEAF_MATCHES });
+  const tabs = await chrome.tabs.query({ url: OVERLEAF_EDITOR_MATCHES });
   const probes = await Promise.all(tabs.map(tab => probeTabIdle(tab)));
   const nativeGate = await requestInternal({ method: 'update.canApply', params: {} }).catch(error => ({
     ok: false,

package/extension/bootstrap/manifest.template.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Codex Overleaf Link",
-  "version": "1.9.6",
+  "version": "1.9.8",
   "description": "Connect the active Overleaf project to a local Codex bridge.",
   "icons": {
     "16": "assets/icons/icon16.png",
@@ -17,6 +17,8 @@
     "storage"
   ],
   "host_permissions": [
+    "https://www.overleaf.com/project",
+    "https://overleaf.com/project",
     "https://www.overleaf.com/project/*",
     "https://overleaf.com/project/*"
   ],

package/extension/bootstrap/popup.html

@@ -13,18 +13,6 @@
     </div>
     <button id="open-panel" data-popup-context>Open panel in Overleaf</button>
     <p id="status" data-popup-context>Use this on an Overleaf project tab.</p>
-    <section class="updates" aria-labelledby="updates-title">
-      <div class="section-head">
-        <strong id="updates-title">Stable updates</strong>
-        <span id="update-state" class="update-state">Checking</span>
-      </div>
-      <p id="update-versions">Current unknown · Latest unknown</p>
-      <p id="update-detail" class="muted">Automatic updates apply when Overleaf is saved and idle.</p>
-      <div class="update-actions">
-        <button id="check-update" class="secondary" type="button">Check now</button>
-        <button id="postpone-update" class="quiet" type="button" hidden>Later</button>
-      </div>
-    </section>
     <div id="native-install" class="install" data-popup-context hidden>
       <strong>Native host attention required</strong>
       <p>Run this command in Terminal, then reload this extension in Chrome.</p>
@@ -34,6 +22,5 @@
     <script src="../runtime/src/shared/compatibility.js"></script>
     <script src="../runtime/src/popup.js"></script>
     <script src="updateStatus.js"></script>
-    <script src="popup.js"></script>
   </body>
 </html>

package/extension/bootstrap/update.css

@@ -0,0 +1,366 @@
+:root {
+  color-scheme: dark;
+  --canvas: #101310;
+  --surface: #171b17;
+  --line: rgba(215, 230, 217, 0.13);
+  --line-strong: rgba(215, 230, 217, 0.24);
+  --text: #f1f4ef;
+  --muted: #a4aca4;
+  --quiet: #747d75;
+  --green: #86dc94;
+  --blue: #6eb5ff;
+  --amber: #e2bc70;
+  --red: #f28b82;
+  --shadow: 0 24px 70px rgba(0, 0, 0, 0.36);
+  font-family: "Avenir Next", "Segoe UI", sans-serif;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+html,
+body {
+  min-width: 390px;
+  min-height: 500px;
+  margin: 0;
+  background:
+    radial-gradient(circle at 88% 5%, rgba(70, 131, 105, 0.17), transparent 34%),
+    radial-gradient(circle at 8% 88%, rgba(53, 100, 151, 0.13), transparent 38%),
+    var(--canvas);
+  color: var(--text);
+}
+
+body {
+  padding: 0;
+}
+
+button {
+  font: inherit;
+}
+
+.update-shell {
+  width: min(100%, 440px);
+  min-height: 500px;
+  margin: 0 auto;
+  padding: 26px 26px 22px;
+  display: flex;
+  flex-direction: column;
+  animation: shell-enter 180ms ease-out both;
+}
+
+.update-header {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 20px;
+  padding-bottom: 22px;
+  border-bottom: 1px solid var(--line);
+}
+
+.eyebrow,
+.update-kind,
+.version-route,
+.update-detail,
+.persistence-note {
+  margin: 0;
+}
+
+.eyebrow {
+  color: var(--text);
+  font-size: 15px;
+  font-weight: 700;
+  letter-spacing: -0.01em;
+}
+
+.update-kind {
+  margin-top: 3px;
+  color: var(--muted);
+  font-size: 12px;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+
+.status-badge {
+  min-height: 26px;
+  padding: 5px 9px;
+  border: 1px solid var(--line-strong);
+  border-radius: 999px;
+  color: var(--muted);
+  background: rgba(255, 255, 255, 0.025);
+  font-size: 11px;
+  font-weight: 700;
+  letter-spacing: 0.02em;
+  white-space: nowrap;
+}
+
+.status-badge[data-tone="success"] {
+  border-color: rgba(134, 220, 148, 0.34);
+  color: var(--green);
+  background: rgba(72, 143, 84, 0.11);
+}
+
+.status-badge[data-tone="active"] {
+  border-color: rgba(110, 181, 255, 0.34);
+  color: var(--blue);
+  background: rgba(60, 115, 170, 0.12);
+}
+
+.status-badge[data-tone="warning"] {
+  border-color: rgba(226, 188, 112, 0.34);
+  color: var(--amber);
+}
+
+.status-badge[data-tone="error"] {
+  border-color: rgba(242, 139, 130, 0.38);
+  color: var(--red);
+}
+
+.update-summary {
+  padding: 27px 0 18px;
+}
+
+.version-route {
+  color: var(--green);
+  font: 600 12px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace;
+  letter-spacing: 0.01em;
+}
+
+h1 {
+  margin: 8px 0 8px;
+  max-width: 350px;
+  font-size: 27px;
+  line-height: 1.13;
+  letter-spacing: -0.035em;
+}
+
+.update-detail {
+  max-width: 370px;
+  color: var(--muted);
+  font-size: 13px;
+  line-height: 1.55;
+}
+
+.progress-track {
+  position: relative;
+  width: 100%;
+  height: 3px;
+  margin: 1px 0 24px;
+  overflow: hidden;
+  border-radius: 999px;
+  background: rgba(255, 255, 255, 0.09);
+}
+
+.progress-fill {
+  display: block;
+  width: 0;
+  height: 100%;
+  border-radius: inherit;
+  background: linear-gradient(90deg, var(--blue), var(--green));
+  box-shadow: 0 0 15px rgba(110, 181, 255, 0.38);
+  transition: width 240ms ease;
+}
+
+.progress-track[data-indeterminate="true"] .progress-fill {
+  width: 36%;
+  animation: progress-scan 1.25s ease-in-out infinite;
+}
+
+.update-stages {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.update-stages li {
+  position: relative;
+  display: grid;
+  grid-template-columns: 28px 1fr;
+  gap: 12px;
+  min-height: 62px;
+  color: var(--quiet);
+}
+
+.update-stages li:not(:last-child)::after {
+  content: "";
+  position: absolute;
+  top: 27px;
+  bottom: 1px;
+  left: 13px;
+  width: 1px;
+  background: var(--line-strong);
+}
+
+.stage-marker {
+  position: relative;
+  z-index: 1;
+  display: grid;
+  place-items: center;
+  width: 27px;
+  height: 27px;
+  border: 1px solid var(--line-strong);
+  border-radius: 50%;
+  background: var(--canvas);
+  color: var(--quiet);
+  font: 700 11px/1 ui-monospace, SFMono-Regular, Menlo, monospace;
+}
+
+.update-stages strong,
+.update-stages small {
+  display: block;
+}
+
+.update-stages strong {
+  padding-top: 2px;
+  color: inherit;
+  font-size: 13px;
+  line-height: 1.25;
+}
+
+.update-stages small {
+  margin-top: 4px;
+  color: var(--quiet);
+  font-size: 11px;
+  line-height: 1.35;
+}
+
+.update-stages li[data-state="active"] {
+  color: var(--text);
+}
+
+.update-stages li[data-state="active"] .stage-marker {
+  border-color: var(--blue);
+  color: var(--canvas);
+  background: var(--blue);
+  box-shadow: 0 0 0 4px rgba(110, 181, 255, 0.1);
+}
+
+.update-stages li[data-state="done"] {
+  color: var(--green);
+}
+
+.update-stages li[data-state="done"] .stage-marker {
+  border-color: rgba(134, 220, 148, 0.5);
+  color: var(--green);
+  background: rgba(82, 155, 94, 0.14);
+}
+
+.update-stages li[data-state="error"] {
+  color: var(--red);
+}
+
+.update-stages li[data-state="error"] .stage-marker {
+  border-color: rgba(242, 139, 130, 0.62);
+  color: var(--red);
+}
+
+.persistence-note {
+  margin-top: 5px;
+  padding: 12px 0 15px;
+  border-top: 1px solid var(--line);
+  color: var(--muted);
+  font-size: 11px;
+  line-height: 1.45;
+}
+
+.technical-details {
+  margin: 0 0 14px;
+  color: var(--muted);
+  font-size: 11px;
+}
+
+.technical-details summary {
+  cursor: pointer;
+  color: var(--muted);
+}
+
+.technical-details pre {
+  max-height: 100px;
+  margin: 9px 0 0;
+  padding: 10px;
+  overflow: auto;
+  border-radius: 8px;
+  background: rgba(0, 0, 0, 0.24);
+  color: #cbd1cb;
+  font: 10px/1.45 ui-monospace, SFMono-Regular, Menlo, monospace;
+  white-space: pre-wrap;
+}
+
+.update-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 9px;
+  margin-top: auto;
+  padding-top: 4px;
+}
+
+.update-actions button {
+  min-height: 36px;
+  padding: 0 15px;
+  border: 1px solid var(--line-strong);
+  border-radius: 8px;
+  color: var(--text);
+  background: rgba(255, 255, 255, 0.035);
+  font-size: 12px;
+  font-weight: 700;
+  cursor: pointer;
+  transition: border-color 140ms ease, background 140ms ease, transform 140ms ease;
+}
+
+.update-actions button:hover {
+  border-color: rgba(215, 230, 217, 0.38);
+  background: rgba(255, 255, 255, 0.075);
+}
+
+.update-actions button:active {
+  transform: translateY(1px);
+}
+
+.update-actions button:focus-visible,
+.technical-details summary:focus-visible {
+  outline: 2px solid var(--blue);
+  outline-offset: 2px;
+}
+
+.update-actions button[data-kind="primary"] {
+  border-color: #4f9ce5;
+  color: #08131e;
+  background: linear-gradient(180deg, #77bdff, #5aa8ee);
+}
+
+.update-actions button[data-kind="primary"]:hover {
+  border-color: #8bc9ff;
+  background: linear-gradient(180deg, #87c7ff, #67b1f3);
+}
+
+.update-actions button[data-kind="quiet"] {
+  border-color: transparent;
+  color: var(--muted);
+  background: transparent;
+}
+
+.update-actions button:disabled {
+  opacity: 0.5;
+  cursor: default;
+  transform: none;
+}
+
+@keyframes shell-enter {
+  from { opacity: 0; transform: translateY(5px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+@keyframes progress-scan {
+  from { transform: translateX(-120%); }
+  to { transform: translateX(380%); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  *,
+  *::before,
+  *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+  }
+}

package/extension/bootstrap/update.html

@@ -0,0 +1,55 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Codex Overleaf Link Update</title>
+  <link rel="stylesheet" href="update.css">
+</head>
+<body>
+  <main class="update-shell" aria-labelledby="update-title">
+    <header class="update-header">
+      <div>
+        <p class="eyebrow">Codex Overleaf Link</p>
+        <p class="update-kind">Stable Update</p>
+      </div>
+      <span id="status-badge" class="status-badge" data-tone="neutral">Ready</span>
+    </header>
+
+    <section class="update-summary" aria-live="polite" aria-atomic="true">
+      <p id="version-route" class="version-route">Checking installed version</p>
+      <h1 id="update-title">Checking for updates</h1>
+      <p id="update-detail" class="update-detail">Reading the latest saved update state.</p>
+    </section>
+
+    <div id="progress-track" class="progress-track" role="progressbar" aria-label="Update progress" aria-valuemin="0" aria-valuemax="100" aria-valuenow="0" hidden>
+      <span id="progress-fill" class="progress-fill"></span>
+    </div>
+
+    <ol id="update-stages" class="update-stages" aria-label="Update stages">
+      <li data-stage="download">
+        <span class="stage-marker" aria-hidden="true">1</span>
+        <span><strong>Download and verify</strong><small>Fetch the signed stable release and verify its manifest.</small></span>
+      </li>
+      <li data-stage="safe-point">
+        <span class="stage-marker" aria-hidden="true">2</span>
+        <span><strong>Wait for a safe point</strong><small>Protect active Overleaf work before changing runtime files.</small></span>
+      </li>
+      <li data-stage="restart">
+        <span class="stage-marker" aria-hidden="true">3</span>
+        <span><strong>Restart and health check</strong><small>Activate Extension and Native Host together, then verify both.</small></span>
+      </li>
+    </ol>
+
+    <p id="persistence-note" class="persistence-note">This window can stay open while work continues elsewhere. Progress is saved automatically.</p>
+
+    <details id="technical-details" class="technical-details" hidden>
+      <summary>Technical details</summary>
+      <pre id="technical-message"></pre>
+    </details>
+
+    <footer id="update-actions" class="update-actions" aria-label="Update actions"></footer>
+  </main>
+  <script src="update.js"></script>
+</body>
+</html>