fix(terminal): revert macOptionIsMeta, scope Option+Arrow word-jump instead

macOptionIsMeta:true (previous commit) would have turned every
Option-modified keystroke into an ESC-prefixed byte, breaking the
Option-key dead-key accent composition (ñ, á, ü, ...) that
xtermDeadKeyAddon.ts exists to support on Spanish/Portuguese/US-Intl
layouts. Revert it and instead hand-emit ESC b / ESC f only for plain
Option+Left/Option+Right, which readline's default emacs keymap
already binds to backward-word/forward-word — every other Option
chord is left alone.

Also adds a Rust test that runs the real ZDOTDIR-indirection bootstrap
through an actual zsh binary and asserts a stand-in user .zshrc is
sourced, giving real macOS-runner verification of that code path
(previously only reasoned about statically) since local dev here is
Windows.

Author: ohernandezdev

package.json

@@ -1,7 +1,7 @@
 {
   "name": "afkode",
   "private": true,
-  "version": "0.8.16",
+  "version": "0.8.17",
   "type": "module",
   "scripts": {
     "dev": "vite",

src-tauri/Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "afkode"
-version = "0.8.16"
+version = "0.8.17"
 description = "In-game overlay to supervise AI coding agents while you play"
 authors = ["Omar Hernandez"]
 license = "MIT"

src-tauri/Cargo.toml

@@ -523,6 +523,51 @@ mod tests {
         assert_eq!(sh_squote("it's"), r"'it'\''s'");
     }
 
+    // Runs the real ZDOTDIR-indirection bootstrap through an actual zsh
+    // binary (present on the macOS CI runner, where oh-my-zsh sourcing was
+    // otherwise only checkable by hand) and asserts a stand-in for the
+    // user's real .zshrc (an oh-my-zsh install sources exactly the same
+    // way) is reached.
+    #[cfg(not(target_os = "windows"))]
+    #[test]
+    fn zsh_zdotdir_bootstrap_sources_user_zshrc() {
+        if std::process::Command::new("zsh")
+            .arg("--version")
+            .output()
+            .is_err()
+        {
+            eprintln!("zsh not found on this machine, skipping");
+            return;
+        }
+        let tmp = std::env::temp_dir().join(format!("afk-zsh-test-{}", std::process::id()));
+        let user_home = tmp.join("home");
+        std::fs::create_dir_all(&user_home).unwrap();
+        std::fs::write(
+            user_home.join(".zshrc"),
+            "export AFK_TEST_MARKER=from-user-zshrc\n",
+        )
+        .unwrap();
+
+        let integration_dir = write_shell_integration().expect("write_shell_integration failed");
+
+        let output = std::process::Command::new("zsh")
+            .env("ZDOTDIR", integration_dir.join("zdotdir"))
+            .env("AFKODE_USER_ZDOTDIR", &user_home)
+            .args(["-i", "-c", "echo $AFK_TEST_MARKER"])
+            .output()
+            .expect("failed to spawn zsh");
+
+        let stdout = String::from_utf8_lossy(&output.stdout);
+        assert!(
+            stdout.contains("from-user-zshrc"),
+            "expected the ZDOTDIR bootstrap to source the user's real .zshrc; \
+             stdout={stdout:?} stderr={:?}",
+            String::from_utf8_lossy(&output.stderr)
+        );
+
+        let _ = std::fs::remove_dir_all(&tmp);
+    }
+
     #[cfg(target_os = "windows")]
     #[test]
     fn ps_squote_escapes_single_quotes() {

src-tauri/src/lib.rs

@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "AFKode",
-  "version": "0.8.16",
+  "version": "0.8.17",
   "identifier": "app.afkode.overlay",
   "build": {
     "beforeDevCommand": "npm run dev",

src-tauri/tauri.conf.json

@@ -1342,12 +1342,6 @@ async function newSession(
     minimumContrastRatio: 1,
     cursorBlink: true,
     cursorStyle: "bar",
-    // Without this, xterm.js treats Option as a dead-key/composition
-    // modifier on macOS instead of sending ESC-prefixed bytes, so
-    // Option+Left/Right never reach the shell as the ESC b / ESC f
-    // sequences readline (and Claude Code's own Option-based input)
-    // expect for word-wise cursor movement.
-    macOptionIsMeta: true,
     // Memory: 2k lines is plenty for supervision; agents redraw their TUI.
     scrollback: 2000,
     theme: themeDef.term,
@@ -1474,6 +1468,25 @@ async function newSession(
   term.attachCustomKeyEventHandler((ev) => {
     if (deadKey.handle(ev)) return false;
     if (ev.type !== "keydown") return true;
+    // Option+Left/Right word-jump. macOptionIsMeta would fix this at the
+    // xterm.js level, but it turns *every* Option-modified key into an
+    // ESC-prefixed byte — breaking Option-key dead-key accent composition
+    // (ñ, á, ü, ...) that xtermDeadKeyAddon exists to support. So instead
+    // we hand-emit the ESC b / ESC f sequences readline's default emacs
+    // keymap already binds to backward-word/forward-word, scoped to just
+    // these two keys, leaving every other Option chord untouched.
+    if (
+      isMac() &&
+      ev.altKey &&
+      !ev.metaKey &&
+      !ev.ctrlKey &&
+      !ev.shiftKey &&
+      (ev.code === "ArrowLeft" || ev.code === "ArrowRight")
+    ) {
+      ev.preventDefault();
+      invoke("write_pty", { id, data: ev.code === "ArrowLeft" ? "\x1bb" : "\x1bf" }).catch(() => {});
+      return false;
+    }
     // AI command search (F3) — shell tabs only, so agent TUIs never see it.
     // '#' only fires at a verifiably idle, empty prompt (OSC 133 state);
     // Ctrl+Space works regardless, as the explicit opt-in gesture.