fix: dynamic window sizing, Dock auto-hide margin, binary path detection

[okletstryitnow]

Summary

Replaces fixed window dimensions with display-adaptive sizing, adds intelligent Dock margin handling, and fixes Claude binary detection. Eliminates all content clipping issues permanently.

What changed

Dynamic Window Sizing:

• Window now fills the entire display workArea (transparent — no visual difference)
• Replaces hardcoded BAR_WIDTH=1040 / PILL_HEIGHT=720 with display.workAreaSize
• MIN_WIDTH=1040 / MIN_HEIGHT=720 as fallbacks for very small displays
• On display-metrics-changed: window resizes to fit new display (monitor plug/unplug, resolution change)
• Critical fix: Moved reposition handler OUTSIDE SPACES_DEBUG block — was silently no-op in production

Dock Auto-Hide Margin:

• New getBottomMargin(display) reads macOS Dock preferences via defaults read com.apple.dock
• Checks autohide, orientation, and tilesize to calculate correct bottom clearance
• Uses tilesize (not largesize) because cursor is on the pill, not the Dock — magnification is not active
• syncDockMargin() injects --clui-dock-margin CSS variable into the renderer
• Updates on every display-metrics-changed event
• Only applies margin when Dock is bottom + auto-hide (left/right Dock = base margin only)

Binary Path Detection:

• Added ~/.local/bin/claude to binary search candidates in run-manager.ts
• Covers the native installer symlink location

Other:

• .gitignore: development artifacts (.planning/, artifacts/)

Why

The fixed 720px window height caused content to clip above the window boundary whenever the UI grew taller (Marketplace + expanded chat, panels at high scales). Similarly, the fixed 1040px width caused circle buttons to clip at the left edge at 150% scale. Making the window display-sized eliminates this entire category of bugs — the window boundary is now the screen boundary.

The Dock margin fix ensures the pill floats above the macOS Dock when auto-hide is enabled, without hardcoding assumptions about Dock size or position.

Technical Notes

• getBottomMargin() uses execFileSync (synchronous) for defaults read — each call is ~5ms. Called once at startup and on display changes (not in hot paths)
• syncDockMargin() uses executeJavaScript to inject CSS variable — includes typeof number + isFinite guard to prevent template injection
• The display-metrics-changed handler includes !mainWindow.isDestroyed() check

Test Plan

• App fills display workArea (verify with DevTools: window.innerWidth ≈ screen width)
• No content clipping at any pill scale (75%-150%)
• Marketplace panel fully visible with expanded chat (header not clipped)
• Circle buttons fully accessible at 150% scale (Skills button clickable)
• Pill floats above auto-hide Dock (not touching screen bottom)
• Dock on left/right: minimal bottom margin (24px)
• Unplug external monitor → window adapts to MacBook screen
• ~/.local/bin/claude detected as Claude binary

---

🤖 Generated with Claude Code