feat: rich terminal context, editor enrichment, and multi-window fix

[kepptic]

Summary

Comprehensive enhancement to the VS Code watcher — adds terminal tracking, git enrichment, multi-window safety, and incorporates community PRs #36, #39, #40.

Terminal Context

• Active terminal name & cwd: Reports the focused terminal's working directory via shellIntegration API with lsof PID-based fallback (for terminals like Claude Code that lack shell integration)
• Terminal switch detection: Distinguishes same-named terminals using array-index identity
• All terminal enumeration: Reports all open terminal sessions with resolved project names
• 500ms timeout on terminal.processId (Thenable) to prevent hung heartbeats

Editor Enrichment

• Git dirty count & remote URL — per-file repository resolution (not just repositories[0])
• Cursor position — line and column
• Debug session tracking — active session type
• Relative file paths — cleaner than absolute
• Open editor tabs — filenames and count
• Window focus state (is_focused)
• Multi-root workspace folders

Multi-Window Fix

• Only the focused VS Code window sends heartbeats. Multiple windows share the same bucket — unfocused windows were interleaving different project data, breaking aw-server's pulse merge and producing 0-duration events. One final heartbeat fires on blur to properly close the current event.

Community PRs Merged

• feat: send workspace name #36 (@Thopiax) — workspace field from .code-workspace name
• Add editor label to data #39 (@fooman) — editor field, enhanced to use dynamic env.appName (supports Cursor, Windsurf, and other VS Code forks)
• Support untrusted workspaces #40 (@ishanarora) — untrusted workspace support (capabilities.untrustedWorkspaces.supported: true)

New Heartbeat Fields

Field	Description
editor	Editor app name (VS Code, Cursor, etc.)
workspace	Workspace name from .code-workspace
active_terminal	Active terminal name
active_terminal_label	Terminal name + project directory
terminal_cwd	Terminal working directory
terminal_description	Project directory name
terminal_names	All terminals with project names (; separated)
terminal_count	Number of open terminals
git_dirty_count	Uncommitted changes count
git_remote	Git remote URL (cleaned)
is_debugging / debug_type	Active debug session
cursor_line / cursor_col	Cursor position
lines_in_file	Total lines in file
relative_path	File path relative to workspace
open_files / open_file_count	Open editor tabs
is_focused	Window focus state
workspace_folders	Multi-root workspace folder names

Test plan

• Terminal switches fire heartbeats with correct active terminal
• PID-based lsof resolves cwd for terminals without shellIntegration
• Multiple terminals with same name are distinguished by index
• 500ms timeout prevents hung processId promises
• All terminal sessions enumerated with project names
• Git, cursor, debug, and focus data included in heartbeats
• Only focused window sends heartbeats (multi-window)
• One final heartbeat on blur to close event properly
• editor field dynamically detects Cursor/Windsurf/VS Code
• workspace field populated from .code-workspace name
• Extension works in untrusted workspaces

---

Note: We also maintain an enhanced fork at kepptic/aw-watcher-vscode-enhanced with modernized build tooling (TypeScript 5.x, ESLint, updated deps) for users who want these features now.