[nwparker]

Summary

Wire the two shell-integration escape sequences that xterm.js does not handle natively, continuing the pattern established by #896 (DEC 2031) and #952 (OSC 52):

• OSC 7 — the shell's current working directory, emitted on every cd by a shell whose rc includes a precmd hook. Recorded per-pane in paneCwdRef.
• OSC 133 — FinalTerm / iTerm semantic prompt marks (A = prompt start, B = prompt end, C = command end, D[;code] = done). Recorded per-pane in a capped ring buffer with buffer-row coordinates.

Shipped consumer

The terminal context menu grows a platform-aware Reveal in Finder / Show in Explorer / Open Folder item that opens the shell's current directory in the native file manager. The item is hidden when no OSC 7 has been observed, consistent with how iTerm/tmux surface shell-integration-dependent features.

This gives users an immediate reason to enable OSC 7 in their rc and proves the plumbing works end-to-end — the anti-pattern of shipping infrastructure without consumers was explicitly discussed in the design pass.

Recorded-only (no consumer yet)

OSC 133 marks are recorded but no UI surfaces them. Recording is cheap (a push onto a ring buffer), and the consumer UX (block-nav keybinds, exit-code gutters, per-command timing) deserves its own design debate. Landing the recording now means future consumer PRs won't also have to add the parsing.

Design

See docs/shell-integration-design.md in the local worktree (gitignored per project convention for *-design.md).

Module layout

• src/renderer/src/components/terminal-pane/shell-integration.ts — pure parsers (parseOsc7Path, parseOsc133Payload, pushSemanticMark).
• src/renderer/src/components/terminal-pane/shell-integration.test.ts — 21 unit tests.
• use-terminal-pane-lifecycle.ts — register/dispose handlers per-pane, populate the two refs.
• use-terminal-pane-context-menu.ts — expose menuPaneCwd + onRevealCwd on the menu state.
• TerminalContextMenu.tsx — render the platform-labeled Reveal item.

Memory safety

• Cwd: one string per pane, dropped in onPaneClosed.
• Marks: ring buffer capped at 10 000 entries per pane (~400 KB upper bound).

Security / Safety

• OSC 7: file:// URI only; non-file schemes return null. Passed unchanged to shell.showItemInFolder via the existing shell:openPath IPC (which is read-only — it just selects the directory in the OS file manager).
• OSC 133: inert recording — no code path reads exitCode or row in this PR.

Known non-goals (explicit)

• Split inherits cwd. Requires extending PaneManager.splitPane to accept a per-pane cwd override and threading it through connectPanePty. Separate design, ~3× this PR's footprint.
• OSC 133 UI. Deferred pending UX design.
• Shell rc auto-injection. Users install the precmd snippet manually today. Auto-injection needs rc-file ownership / uninstall semantics / Fish + PowerShell variants — separate design.

Testing

• pnpm lint
• pnpm typecheck
• 21 new parser unit tests, 134/134 terminal-pane tests passing
• Manual: add printf '\e]7;file://%s%s\a' "$HOSTNAME" "$PWD" to ~/.zshrc precmd, confirm Reveal in Finder opens the current directory