codex-overleaf-link 1.3.6 → 1.3.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.3.6-blue" alt="version">
+    <img src="https://img.shields.io/badge/version-1.3.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 native host **and** sets up the extension: the script r
 macOS / Linux:
 
 ```bash
-CODEX_OVERLEAF_REF=v1.3.6 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.3.6/install.sh)"
+CODEX_OVERLEAF_REF=v1.3.7 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.3.7/install.sh)"
 ```
 
 Windows PowerShell:
 
 ```powershell
-iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.3.6/install.ps1 -OutFile install.ps1
-$env:CODEX_OVERLEAF_REF='v1.3.6'
+iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.3.7/install.ps1 -OutFile install.ps1
+$env:CODEX_OVERLEAF_REF='v1.3.7'
 powershell -ExecutionPolicy Bypass -File install.ps1
 ```
 
@@ -56,10 +56,10 @@ Then, in the `chrome://extensions` tab the script opened: enable **Developer mod
 `npm exec` installs and updates the **native host only** — it does not include the Chrome extension. Use it if you prefer a pinned npm package to a source checkout.
 
 ```bash
-npm exec --yes codex-overleaf-link@1.3.6 -- install-native
+npm exec --yes codex-overleaf-link@1.3.7 -- install-native
 ```
 
-Then add the extension yourself: download `codex-overleaf-link-extension-v1.3.6.zip` from the [v1.3.6 GitHub Release](https://github.com/Ghqqqq/codex-overleaf-link/releases/tag/v1.3.6), unzip it to a stable folder, and in `chrome://extensions` enable **Developer mode**, click **Load unpacked**, and select that folder.
+Then add the extension yourself: download `codex-overleaf-link-extension-v1.3.7.zip` from the [v1.3.7 GitHub Release](https://github.com/Ghqqqq/codex-overleaf-link/releases/tag/v1.3.7), unzip it to a stable folder, and in `chrome://extensions` enable **Developer mode**, click **Load unpacked**, and select that folder.
 
 ### Open Overleaf
 
@@ -86,9 +86,9 @@ npm installs, updates, uninstalls, and diagnoses the native host only. npm does
 
 | Action | Command |
 |--------|---------|
-| Install / update | `npm exec --yes codex-overleaf-link@1.3.6 -- install-native` |
-| Diagnose | `npm exec --yes codex-overleaf-link@1.3.6 -- doctor` |
-| Uninstall | `npm exec --yes codex-overleaf-link@1.3.6 -- uninstall-native` |
+| Install / update | `npm exec --yes codex-overleaf-link@1.3.7 -- install-native` |
+| Diagnose | `npm exec --yes codex-overleaf-link@1.3.7 -- doctor` |
+| Uninstall | `npm exec --yes codex-overleaf-link@1.3.7 -- uninstall-native` |
 
 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 @@ To update, re-run any of the [native host installers](#install) — they install
 
 ## GitHub Release Artifacts
 
-The v1.3.6 GitHub Release contains:
+The v1.3.7 GitHub Release contains:
 
-- `codex-overleaf-link-extension-v1.3.6.zip`: loadable Chrome extension package for manual unpacked installation.
-- `codex-overleaf-native-host-v1.3.6.tar.gz`: native host runtime files used by the installer and release verification.
-- `codex-overleaf-link-1.3.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.3.6` when run directly from the release artifact.
-- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.3.6` when run directly from the release artifact.
+- `codex-overleaf-link-extension-v1.3.7.zip`: loadable Chrome extension package for manual unpacked installation.
+- `codex-overleaf-native-host-v1.3.7.tar.gz`: native host runtime files used by the installer and release verification.
+- `codex-overleaf-link-1.3.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.3.7` when run directly from the release artifact.
+- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.3.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.3.6 GitHub Release contains:
 Remove the native host (use `--browser chromium` on Linux Chromium):
 
 ```bash
-npm exec --yes codex-overleaf-link@1.3.6 -- uninstall-native
+npm exec --yes codex-overleaf-link@1.3.7 -- uninstall-native
 ```
 
 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.3.6 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.3.6/install.sh)" -- --browser chromium
+CODEX_OVERLEAF_REF=v1.3.7 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.3.7/install.sh)" -- --browser chromium
 ```
 
 Linux Chromium uninstall:
 
 ```bash
-npm exec --yes codex-overleaf-link@1.3.6 -- uninstall-native --browser chromium
+npm exec --yes codex-overleaf-link@1.3.7 -- uninstall-native --browser chromium
 ```
 
 ## Features
@@ -167,6 +167,7 @@ npm exec --yes codex-overleaf-link@1.3.6 -- uninstall-native --browser chromium
 - **Diff review** — per-file diff view before accepting changes.
 - **Undo checkpoint** — one-click revert of browser writes.
 - **Track Changes integration** — optionally enables Overleaf Reviewing before writing.
+- **Accept / Undo per run** — when a run wrote in Reviewing mode, accept or revert all of its tracked changes from the run card in one click. Accept replays the run's edits as untracked text via Overleaf's native undo path, with stable-Editing waits and an automatic rollback if Overleaf reintroduces tracked changes during the replay.
 - **Auto-recompile** — triggers Overleaf recompile after writeback; logs compile errors as context.
 - **@ context** — attach specific files, `@compile-log`, or `@current-section` to the prompt.
 - **Composer attachments and binary writeback** — paste or drop PDFs, images, and files into the composer as turn-scoped Codex context, and review Codex-created assets before creating or replacing them in Overleaf.
@@ -288,7 +289,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.3.6 -- install-native
+npm exec --yes codex-overleaf-link@1.3.7 -- install-native
 ```
 
 **The Windows popup or panel shows a Bash recovery command**
@@ -337,8 +338,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.3.6 -- install-native` | `npm exec --yes codex-overleaf-link@1.3.6 -- install-native` | `npm exec --yes codex-overleaf-link@1.3.6 -- install-native` | `npm exec --yes codex-overleaf-link@1.3.6 -- install-native --browser chromium` |
-| Uninstall command | `npm exec --yes codex-overleaf-link@1.3.6 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.3.6 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.3.6 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.3.6 -- uninstall-native --browser chromium` |
+| Installer/update command | `npm exec --yes codex-overleaf-link@1.3.7 -- install-native` | `npm exec --yes codex-overleaf-link@1.3.7 -- install-native` | `npm exec --yes codex-overleaf-link@1.3.7 -- install-native` | `npm exec --yes codex-overleaf-link@1.3.7 -- install-native --browser chromium` |
+| Uninstall command | `npm exec --yes codex-overleaf-link@1.3.7 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.3.7 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.3.7 -- uninstall-native` | `npm exec --yes codex-overleaf-link@1.3.7 -- uninstall-native --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. |

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.3.6';
+  const BUILD_TARGET_VERSION = '1.3.7';
   const DEFAULT_CHROME_EXTENSION_ID = 'illdpneeeopfffmiepaejglgmhpmdhdc';
   const REQUIRED_CAPABILITIES = Object.freeze([
     'bridgePing',

package/extension/src/shared/i18n.js

@@ -123,6 +123,24 @@
       undoCheckpointMissingReason: 'This run wrote while Reviewing/Track Changes was enabled, but the extension could not reliably identify the tracked changes generated by Overleaf. To avoid creating new redlines with text patches, automatic undo is disabled.',
       undoCheckpointMissingNext: 'Reject this run manually in Overleaf review tools, or rerun and try again.',
       undoCheckpointPlain: 'Undo point created: this run has {count} reversible write(s)',
+      runAcceptTracked: 'Accept changes',
+      runAcceptTrackedTitle: 'Accept this run\'s Overleaf tracked changes',
+      runAcceptTrackedConfirm: 'Confirm accept',
+      runAcceptTrackedCancel: 'Cancel',
+      runAcceptTrackedConfirming: 'Accepting…',
+      runAcceptTrackedDone: 'Accepted',
+      runAcceptTrackedDoneTitle: 'This run\'s tracked changes have been accepted',
+      runAcceptTrackedStarted: 'Starting to accept this run\'s Overleaf tracked changes',
+      runAcceptTrackedResult: 'Accept result: accepted {applied} tracked change(s), skipped {skipped}',
+      runAcceptTrackedFailed: 'Accept changes could not be completed',
+      runAcceptTrackedFailedReason: 'Overleaf editor content has drifted from this run\'s writeback, so Codex did not change the document. The run stays pending — retry Accept changes.',
+      runAcceptTrackedStepEditorUndo: 'Accept step 1/6 — Overleaf editor-undo of this run\'s tracked writeback',
+      runAcceptTrackedStepModeBefore: 'Accept step 2/6 — Reviewing/Track Changes state read BEFORE the Editing toggle',
+      runAcceptTrackedStepForceEditing: 'Accept step 3/6 — forcing Editing mode (Track Changes OFF) for the untracked replay',
+      runAcceptTrackedStepReplayStart: 'Accept step 4/6 — per-operation re-check of Editing mode before writing {path}',
+      runAcceptTrackedStepReplayDone: 'Accept step 5/6 — untracked replay write completed for {path}',
+      runAcceptTrackedStepRestoreReviewing: 'Accept step 6/6 — restoring the prior Reviewing/Track Changes mode',
+      detailAccepted: 'Accepted',
       deleteFilePromptTitle: 'Allow Codex to delete files?',
       deleteFilePromptMessage: '{files}\n\nOther changes can still sync if deletion is not confirmed.',
       deleteFileConfirm: 'Allow delete',
@@ -394,6 +412,24 @@
       undoCheckpointMissingReason: '本轮是在 Reviewing/Track Changes 下写入的，但插件没有可靠识别 Overleaf 生成的留痕记录。为了避免用文本补丁制造新的红线，自动撤销已禁用。',
       undoCheckpointMissingNext: '请在 Overleaf 审阅面板手动拒绝这轮建议，或重新运行后再尝试。',
       undoCheckpointPlain: '已创建撤销点：可撤销本轮 {count} 项写入',
+      runAcceptTracked: '接受改动',
+      runAcceptTrackedTitle: '接受本轮 Overleaf 留痕改动',
+      runAcceptTrackedConfirm: '确认接受',
+      runAcceptTrackedCancel: '取消',
+      runAcceptTrackedConfirming: '接受中…',
+      runAcceptTrackedDone: '已接受',
+      runAcceptTrackedDoneTitle: '本轮留痕改动已被接受',
+      runAcceptTrackedStarted: '开始接受本轮 Overleaf 留痕改动',
+      runAcceptTrackedResult: '接受结果：已接受 {applied} 条留痕，跳过 {skipped} 条',
+      runAcceptTrackedFailed: '没有完成接受改动',
+      runAcceptTrackedFailedReason: 'Overleaf 编辑器内容已经和本轮写入不一致，Codex 没有改动文档。本轮仍为待处理状态——请重新点击接受改动。',
+      runAcceptTrackedStepEditorUndo: '接受步骤 1/6 — 通过 Overleaf 编辑器撤销，回退本轮留痕写入',
+      runAcceptTrackedStepModeBefore: '接受步骤 2/6 — 强制切换 Editing 之前读取的 Reviewing/Track Changes 状态',
+      runAcceptTrackedStepForceEditing: '接受步骤 3/6 — 强制切换到 Editing 模式（Track Changes OFF）以便重放为永久文本',
+      runAcceptTrackedStepReplayStart: '接受步骤 4/6 — 写入 {path} 前再次校验 Editing 模式',
+      runAcceptTrackedStepReplayDone: '接受步骤 5/6 — 已完成 {path} 的无留痕重放写入',
+      runAcceptTrackedStepRestoreReviewing: '接受步骤 6/6 — 恢复之前的 Reviewing/Track Changes 模式',
+      detailAccepted: '已接受',
       deleteFilePromptTitle: '允许 Codex 删除文件？',
       deleteFilePromptMessage: '{files}\n\n未确认删除时，其它改动仍可继续同步。',
       deleteFileConfirm: '允许删除',

package/extension/src/shared/sessionState.js

@@ -38,6 +38,12 @@
   const VALID_LOCALES = new Set(['en', 'zh']);
   const VALID_EVENT_STATUSES = new Set(['info', 'running', 'completed', 'failed', 'warning', 'blocked', 'skipped', 'pending']);
   const VALID_TITLE_SOURCES = new Set(['auto', 'manual']);
+  const VALID_TRACKED_CHANGE_STATUS = new Set([
+    'pending',
+    'accepted',
+    'rejected'
+  ]);
+  const TERMINAL_TRACKED_CHANGE_STATUS = new Set(['accepted', 'rejected']);
   const LEGACY_DEFAULT_SESSION_TITLE = 'New task';
   const SESSION_AUTO_TITLE_CHARS = 24;
   const MAX_RUN_EVENTS = 300;
@@ -515,7 +521,7 @@
       });
     }
 
-    return {
+    const normalized = {
       id: run.id,
       task: sanitizeAssistantVisibleText(run.task) || 'untitled task',
       mode: typeof run.mode === 'string' ? run.mode : '',
@@ -535,6 +541,57 @@
       undoExpectedFiles: normalizeRunFiles(run.undoExpectedFiles),
       undoStatus: sanitizeAssistantVisibleText(run.undoStatus)
     };
+
+    applyTrackedChangeStatus(normalized, run.trackedChangeStatus);
+
+    return normalized;
+  }
+
+  // Resolves `trackedChangeStatus` on an already-normalized run via three ordered
+  // steps: (1) value recovery, (2) migration of pre-feature runs, (3) terminal
+  // payload cleanup. Mutates `run` in place. Idempotent: re-running it on its own
+  // output yields the same result.
+  function applyTrackedChangeStatus(run, rawStatus) {
+    const hasRefs = run.undoTrackedChanges.length > 0;
+    const hasRawStatus = rawStatus !== undefined && rawStatus !== null && rawStatus !== '';
+
+    // Step 1 — value recovery. Keep a stable value; recover any other present
+    // value (corruption, an old persisted `partial_accept` / `partial_reject` /
+    // `resolved_elsewhere`, a stray in-flight value) to `pending` (with refs)
+    // or drop it. An absent value falls through.
+    let status;
+    if (VALID_TRACKED_CHANGE_STATUS.has(rawStatus)) {
+      status = rawStatus;
+    } else if (hasRawStatus) {
+      status = hasRefs ? 'pending' : undefined;
+    } else {
+      status = undefined;
+    }
+
+    // Step 1 — reload reconciliation. A non-terminal status (`pending`) with no
+    // refs is the post-reload state of an un-acted tracked-change run: the heavy refs are
+    // never persisted, so without them there is nothing to act on. Drop it so
+    // the run returns to the legacy-undo world. A terminal status with no refs
+    // is kept — step 3 already empties terminal payloads and the label stays
+    // meaningful.
+    if (!hasRefs && status !== undefined && !TERMINAL_TRACKED_CHANGE_STATUS.has(status)) {
+      status = undefined;
+    }
+
+    // Step 2 — migration of pre-feature runs (no status after step 1).
+    if (status === undefined && hasRefs) {
+      status = run.undoStatus === 'applied' ? 'rejected' : 'pending';
+    }
+
+    // Step 3 — terminal payload cleanup; keeps `trackedChangeStatus`.
+    if (TERMINAL_TRACKED_CHANGE_STATUS.has(status)) {
+      run.undoTrackedChanges = [];
+      run.undoExpectedFiles = [];
+    }
+
+    if (status !== undefined) {
+      run.trackedChangeStatus = status;
+    }
   }
 
   function normalizeRunStatus(status) {
@@ -861,7 +918,7 @@
 
   function compactRunForStorage(run, limits, keepUndoPayload) {
     const undoPayload = compactUndoPayload(run, limits, keepUndoPayload);
-    return {
+    const compact = {
       id: run.id,
       task: summarizeTextForStorage(run.task || 'untitled task', 'run task'),
       mode: typeof run.mode === 'string' ? run.mode : '',
@@ -881,6 +938,10 @@
       undoExpectedFiles: undoPayload.undoExpectedFiles,
       undoStatus: summarizeTextForStorage(run.undoStatus, 'undo status')
     };
+    if (VALID_TRACKED_CHANGE_STATUS.has(run.trackedChangeStatus)) {
+      compact.trackedChangeStatus = run.trackedChangeStatus;
+    }
+    return compact;
   }
 
   function compactRunEvents(events, limits) {

package/extension/src/shared/storageDb.js

@@ -38,6 +38,11 @@
     skipped: true,
     pending: true
   };
+  var VALID_TRACKED_CHANGE_STATUSES = {
+    pending: true,
+    accepted: true,
+    rejected: true
+  };
   var SECRET_REDACTION_PATTERNS = [
     /-----BEGIN [A-Z0-9 ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z0-9 ]*PRIVATE KEY-----/g,
     /\bBearer\s+[A-Za-z0-9._~+/=-]{12,}/gi,
@@ -542,7 +547,7 @@
   }
 
   function compactRunForStorage(run) {
-    return {
+    var compact = {
       id: run.id,
       task: normalizeDisplayTextForStorage(run.task || 'untitled task', SESSION_STORAGE_LIMITS.taskChars),
       mode: typeof run.mode === 'string' ? redactSecretLikeText(run.mode) : '',
@@ -562,6 +567,10 @@
       undoExpectedFiles: [],
       undoStatus: normalizeDisplayTextForStorage(run.undoStatus, SESSION_STORAGE_LIMITS.statusTextChars)
     };
+    if (VALID_TRACKED_CHANGE_STATUSES[run.trackedChangeStatus] === true) {
+      compact.trackedChangeStatus = run.trackedChangeStatus;
+    }
+    return compact;
   }
 
   function compactRunEventsForStorage(events) {

package/package.json

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