codex-overleaf-link 1.9.6 → 1.9.7

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.7-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.7 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.7/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.7/install.ps1 -OutFile install.ps1
+$env:CODEX_OVERLEAF_REF='v1.9.7'
 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.7 -- 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.7 -- install-managed` |
+| Diagnose | `npm exec --yes codex-overleaf-link@1.9.7 -- doctor` |
+| Uninstall | `npm exec --yes codex-overleaf-link@1.9.7 -- 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.7 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.7.zip`: loadable Chrome extension package for manual unpacked installation.
+- `codex-overleaf-native-host-v1.9.7.tar.gz`: native host runtime files used by the installer and release verification.
+- `codex-overleaf-link-1.9.7.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.7` when run directly from the release artifact.
+- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.9.7` 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.7 -- 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.7 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.7/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.7 -- 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.7 -- 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.7 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.7 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.7 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.7 -- install-managed --browser chromium` |
+| Uninstall command | `npm exec --yes codex-overleaf-link@1.9.7 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.7 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.7 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.7 -- 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.7 -- 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.7 -- 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.7 -- uninstall-native
 ```

package/extension/bootstrap/manifest.template.json

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

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>

package/extension/bootstrap/update.js

@@ -0,0 +1,334 @@
+(() => {
+  'use strict';
+
+  const MESSAGE_TYPES = Object.freeze({
+    get: 'codex-overleaf/consent-update-get-state',
+    check: 'codex-overleaf/consent-update-check',
+    install: 'codex-overleaf/consent-update-install',
+    later: 'codex-overleaf/consent-update-later',
+    retry: 'codex-overleaf/consent-update-check'
+  });
+  const ACTIVE_PHASES = new Set([
+    'checking',
+    'downloading',
+    'staged',
+    'waiting',
+    'waiting_for_idle',
+    'waiting_for_safe_point',
+    'applying',
+    'awaiting_health',
+    'awaiting_health_check',
+    'health_checking'
+  ]);
+
+  const elements = {
+    badge: document.getElementById('status-badge'),
+    title: document.getElementById('update-title'),
+    route: document.getElementById('version-route'),
+    detail: document.getElementById('update-detail'),
+    progressTrack: document.getElementById('progress-track'),
+    progressFill: document.getElementById('progress-fill'),
+    stages: Array.from(document.querySelectorAll('#update-stages > li')),
+    note: document.getElementById('persistence-note'),
+    details: document.getElementById('technical-details'),
+    technicalMessage: document.getElementById('technical-message'),
+    actions: document.getElementById('update-actions')
+  };
+
+  let currentView = {};
+  let pollTimer = null;
+  let refreshTimer = null;
+  let actionPending = false;
+
+  function asObject(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+  }
+
+  function unwrapResponse(response) {
+    const root = asObject(response) || {};
+    if (root.ok === false) {
+      const error = new Error(root.error?.message || root.message || 'Update action failed.');
+      error.code = root.error?.code || root.code || 'update_failed';
+      throw error;
+    }
+    const candidates = [
+      root.view,
+      root.result?.view,
+      root.result,
+      root.updateConsent,
+      root.updateState,
+      root.state
+    ];
+    return candidates.find(asObject) || root;
+  }
+
+  async function request(action) {
+    const type = MESSAGE_TYPES[action];
+    if (!type) throw new Error(`Unsupported update action: ${action}`);
+    return unwrapResponse(await chrome.runtime.sendMessage({ type }));
+  }
+
+  function phaseOf(view) {
+    const value = view.phase || view.status || view.state || view.lifecycle || 'idle';
+    return typeof value === 'string' ? value.toLowerCase().replace(/[- ]+/g, '_') : 'idle';
+  }
+
+  function versionOf(view, candidates, fallback = '') {
+    for (const key of candidates) {
+      const value = view[key];
+      if (typeof value === 'string' && value.trim()) return value.trim().replace(/^v/i, '');
+    }
+    return fallback;
+  }
+
+  function presentationFor(view) {
+    const phase = phaseOf(view);
+    const presentations = {
+      idle: ['Stable updates', 'Automatically checks signed stable releases.', 'Ready', 'neutral'],
+      up_to_date: ['Everything is up to date', 'Extension and Native Host are on the latest stable release.', 'Up to date', 'success'],
+      checking: ['Checking for updates', 'Reading the latest signed stable release.', 'Checking', 'active'],
+      update_available: ['A stable update is ready', 'Review the target version, then update when convenient.', 'Available', 'success'],
+      downloading: ['Downloading the signed release', 'The package is being fetched and verified before any files change.', 'Downloading', 'active'],
+      staged: ['Update verified', 'The signed package is ready and waiting for a safe installation point.', 'Verified', 'active'],
+      waiting: ['Waiting for a safe point', 'Active Overleaf work will finish before the runtime changes.', 'Waiting', 'warning'],
+      waiting_for_idle: ['Waiting for a safe point', 'Active Overleaf work will finish before the runtime changes.', 'Waiting', 'warning'],
+      waiting_for_safe_point: ['Waiting for a safe point', 'Active Overleaf work will finish before the runtime changes.', 'Waiting', 'warning'],
+      applying: ['Installing the update', 'Extension and Native Host are being switched as one managed unit.', 'Installing', 'active'],
+      awaiting_health: ['Verifying the installation', 'The updated components are restarting and reconnecting.', 'Verifying', 'active'],
+      awaiting_health_check: ['Verifying the installation', 'The updated components are restarting and reconnecting.', 'Verifying', 'active'],
+      health_checking: ['Verifying the installation', 'The updated components are restarting and reconnecting.', 'Verifying', 'active'],
+      committed: ['Update complete', 'Extension and Native Host passed the post-update health check.', 'Complete', 'success'],
+      failed: ['Update could not continue', 'No further update steps will run until the failure is retried.', 'Needs attention', 'error'],
+      rolled_back: ['Previous version restored', 'The health check failed, so the managed update was rolled back safely.', 'Rolled back', 'warning'],
+      deferred: ['Update paused', 'The available update will remain ready for a later installation.', 'Later', 'neutral']
+    };
+    const [title, detail, badge, tone] = presentations[phase] || presentations.idle;
+    return { phase, title, detail, badge, tone };
+  }
+
+  function progressFor(view, phase) {
+    const raw = asObject(view.progress)?.percent ?? view.progressPercent ?? view.progress;
+    if (Number.isFinite(Number(raw))) {
+      const numeric = Number(raw);
+      return Math.max(0, Math.min(100, numeric <= 1 ? numeric * 100 : numeric));
+    }
+    const fallback = {
+      checking: 8,
+      update_available: 0,
+      downloading: 25,
+      staged: 48,
+      waiting: 55,
+      waiting_for_idle: 55,
+      waiting_for_safe_point: 55,
+      applying: 75,
+      awaiting_health: 90,
+      awaiting_health_check: 90,
+      health_checking: 90,
+      committed: 100,
+      rolled_back: 100
+    };
+    return fallback[phase] ?? 0;
+  }
+
+  function activeStageFor(phase) {
+    if (['downloading'].includes(phase)) return 0;
+    if (['staged', 'waiting', 'waiting_for_idle', 'waiting_for_safe_point'].includes(phase)) return 1;
+    if (['applying', 'awaiting_health', 'awaiting_health_check', 'health_checking'].includes(phase)) return 2;
+    if (phase === 'committed') return 3;
+    return -1;
+  }
+
+  function errorStageFor(view, phase) {
+    if (!['failed', 'rolled_back'].includes(phase)) return -1;
+    const stage = String(view.failureStage || view.error?.stage || '').toLowerCase();
+    if (/download|verify|signature|manifest/.test(stage)) return 0;
+    if (/idle|safe|wait/.test(stage)) return 1;
+    return 2;
+  }
+
+  function technicalText(view) {
+    const value = view.technicalDetail || view.error?.technicalDetail || view.error?.message || view.error || view.message;
+    if (!value) return '';
+    if (typeof value === 'string') return value;
+    try {
+      return JSON.stringify(value, null, 2);
+    } catch {
+      return String(value);
+    }
+  }
+
+  function actionDefinitions(phase) {
+    if (phase === 'update_available') {
+      return [
+        { id: 'later', label: 'Later', kind: 'quiet' },
+        { id: 'install', label: 'Update now', kind: 'primary' }
+      ];
+    }
+    if (['failed', 'rolled_back'].includes(phase)) {
+      return [
+        { id: 'close', label: 'Close', kind: 'quiet' },
+        { id: 'retry', label: 'Retry', kind: 'primary' }
+      ];
+    }
+    if (phase === 'committed') {
+      return [{ id: 'close', label: 'Done', kind: 'primary' }];
+    }
+    if (ACTIVE_PHASES.has(phase)) {
+      return [{ id: 'close', label: 'Close window', kind: 'quiet' }];
+    }
+    return [
+      { id: 'close', label: 'Close', kind: 'quiet' },
+      { id: 'check', label: 'Check latest', kind: 'primary' }
+    ];
+  }
+
+  function renderActions(phase) {
+    elements.actions.replaceChildren(...actionDefinitions(phase).map(action => {
+      const button = document.createElement('button');
+      button.type = 'button';
+      button.dataset.action = action.id;
+      button.dataset.kind = action.kind;
+      button.textContent = action.label;
+      button.disabled = actionPending;
+      return button;
+    }));
+  }
+
+  function render(view) {
+    currentView = asObject(view) || {};
+    const presentation = presentationFor(currentView);
+    const installed = versionOf(currentView, ['currentVersion', 'installedVersion', 'extensionVersion'], chrome.runtime.getManifest().version);
+    const target = versionOf(currentView, ['latestVersion', 'targetVersion', 'availableVersion'], 'latest stable');
+    const hasTarget = target && target !== 'latest stable' && target !== installed;
+    elements.route.textContent = hasTarget ? `v${installed}  →  v${target}` : `Installed v${installed}`;
+    elements.title.textContent = presentation.title;
+    elements.detail.textContent = typeof currentView.detail === 'string' && currentView.detail.trim()
+      ? currentView.detail.trim()
+      : presentation.detail;
+    elements.badge.textContent = presentation.badge;
+    elements.badge.dataset.tone = presentation.tone;
+
+    const progress = progressFor(currentView, presentation.phase);
+    const showProgress = ACTIVE_PHASES.has(presentation.phase) || ['committed', 'rolled_back'].includes(presentation.phase);
+    elements.progressTrack.hidden = !showProgress;
+    elements.progressTrack.dataset.indeterminate = presentation.phase === 'checking' ? 'true' : 'false';
+    elements.progressTrack.setAttribute('aria-valuenow', String(Math.round(progress)));
+    elements.progressFill.style.width = `${progress}%`;
+
+    const activeStage = activeStageFor(presentation.phase);
+    const errorStage = errorStageFor(currentView, presentation.phase);
+    elements.stages.forEach((stage, index) => {
+      let state = 'pending';
+      if (index < activeStage || activeStage === 3) state = 'done';
+      if (index === activeStage) state = 'active';
+      if (index === errorStage) state = 'error';
+      stage.dataset.state = state;
+      const marker = stage.querySelector('.stage-marker');
+      marker.textContent = state === 'done' ? '✓' : String(index + 1);
+    });
+
+    const restarting = ['applying', 'awaiting_health', 'awaiting_health_check', 'health_checking'].includes(presentation.phase);
+    elements.note.textContent = restarting
+      ? 'The extension may restart briefly. This window will reconnect and restore the saved progress.'
+      : 'This window can stay open while work continues elsewhere. Progress is saved automatically.';
+
+    const technical = technicalText(currentView);
+    elements.details.hidden = !technical || !['failed', 'rolled_back'].includes(presentation.phase);
+    elements.technicalMessage.textContent = technical;
+    renderActions(presentation.phase);
+    schedulePolling(presentation.phase);
+  }
+
+  function renderReconnecting() {
+    elements.title.textContent = 'Reconnecting after restart';
+    elements.detail.textContent = 'The saved update state will return when the extension is available again.';
+    elements.badge.textContent = 'Reconnecting';
+    elements.badge.dataset.tone = 'active';
+    elements.progressTrack.hidden = false;
+    elements.progressTrack.dataset.indeterminate = 'true';
+    elements.actions.replaceChildren();
+  }
+
+  function renderLocalFailure(error) {
+    render({
+      ...currentView,
+      phase: 'failed',
+      detail: error?.message || 'Update action failed.',
+      technicalDetail: `${error?.code || 'update_failed'}: ${error?.message || 'Update action failed.'}`
+    });
+  }
+
+  function isTransientContextError(error) {
+    return /context invalidated|receiving end does not exist|message port closed|could not establish connection/i.test(String(error?.message || error));
+  }
+
+  async function refresh() {
+    try {
+      render(await request('get'));
+    } catch (error) {
+      if (isTransientContextError(error)) {
+        renderReconnecting();
+        window.setTimeout(() => window.location.reload(), 900);
+        return;
+      }
+      renderLocalFailure(error);
+    }
+  }
+
+  function scheduleRefresh() {
+    window.clearTimeout(refreshTimer);
+    refreshTimer = window.setTimeout(refresh, 80);
+  }
+
+  function schedulePolling(phase) {
+    window.clearTimeout(pollTimer);
+    pollTimer = null;
+    if (!ACTIVE_PHASES.has(phase)) return;
+    pollTimer = window.setTimeout(async () => {
+      await refresh();
+    }, 1100);
+  }
+
+  async function runAction(action) {
+    if (actionPending) return;
+    if (action === 'close') {
+      window.close();
+      return;
+    }
+    actionPending = true;
+    renderActions(phaseOf(currentView));
+    try {
+      render(await request(action));
+      if (action === 'later') window.close();
+    } catch (error) {
+      if (isTransientContextError(error)) {
+        renderReconnecting();
+        window.setTimeout(() => window.location.reload(), 900);
+      } else {
+        renderLocalFailure(error);
+      }
+    } finally {
+      actionPending = false;
+      if (document.visibilityState !== 'unloaded') renderActions(phaseOf(currentView));
+    }
+  }
+
+  elements.actions.addEventListener('click', event => {
+    const button = event.target.closest('button[data-action]');
+    if (button) runAction(button.dataset.action);
+  });
+
+  try {
+    chrome.storage.onChanged.addListener((_changes, areaName) => {
+      if (areaName === 'local') scheduleRefresh();
+    });
+  } catch {
+    renderReconnecting();
+  }
+
+  const requestedAction = new URLSearchParams(window.location.search).get('action');
+  window.history.replaceState(null, '', window.location.pathname);
+  refresh().then(() => {
+    if (requestedAction && ['install', 'retry'].includes(requestedAction)) runAction(requestedAction);
+  });
+})();

package/extension/src/popup.js

@@ -303,8 +303,27 @@
     return section;
   }
 
-  async function sendConsentAction(action) {
-    const type = {
+function openUpdateCenter(action = '') {
+  const url = new URL(chrome.runtime.getURL('bootstrap/update.html'));
+  if (action) url.searchParams.set('action', action);
+  const opened = window.open(
+    url.href,
+    'codex-overleaf-update-center',
+    'popup,width=420,height=540,resizable=yes,scrollbars=yes'
+  );
+  if (opened) {
+    opened.focus();
+    return;
+  }
+  window.location.assign(url.href);
+}
+
+async function sendConsentAction(action) {
+  if (action === 'install' || action === 'retry' || action === 'center') {
+    openUpdateCenter(action === 'center' ? '' : action);
+    action = 'get';
+  }
+  const type = {
       get: 'codex-overleaf/consent-update-get-state',
       check: 'codex-overleaf/consent-update-check',
       install: 'codex-overleaf/consent-update-install',

package/extension/src/shared/compatibility.js

@@ -12,7 +12,7 @@
   const MIN_NATIVE_VERSION = '1.0.0';
   const MIN_COMPATIBLE_NATIVE_VERSION = '1.0.0';
   const MIN_COMPATIBLE_EXTENSION_VERSION = '1.0.0';
-  const BUILD_TARGET_VERSION = '1.9.6';
+  const BUILD_TARGET_VERSION = '1.9.7';
   const DEFAULT_CHROME_EXTENSION_ID = 'illdpneeeopfffmiepaejglgmhpmdhdc';
   const REQUIRED_CAPABILITIES = Object.freeze([
     'bridgePing',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-overleaf-link",
-  "version": "1.9.6",
+  "version": "1.9.7",
   "description": "Cross-platform Chrome bridge that connects Codex to the active Overleaf project.",
   "license": "MIT",
   "type": "commonjs",