# Phantty v0.34.0

## Added

- Added a tag-triggered macOS release workflow that builds signed and
  notarized DMGs for both `aarch64-macos` and `x86_64-macos`, publishes
  them as GitHub release assets, and mirrors the existing Windows
  release flow.
- Bundled the Phantty application icon (`assets/phantty.icns`) into
  `Phantty.app/Contents/Resources` and referenced it from
  `CFBundleIconFile` so Finder, Dock, and cmd-tab pick it up.
- Built an embedded `phantty_docs` agent tool and routed both protocol
  schemas through the in-process docs dispatcher.

## Fixed

- Apple Color Emoji and other sbix / CBDT color-emoji fonts now render
  correctly: FreeType is built with libpng so PNG strikes decode, and
  the font manager falls back to `FT_Select_Size` for bitmap-only faces.
- macOS keyboard input: Cmd-shortcuts now reach the keybind layer,
  `interpretKeyEvents:` no longer rings the system bell on Return /
  Backspace, and Cmd+C / Cmd+V default to the macOS conventional copy /
  paste bindings.
- `.app` bundle launches no longer drop into `/`: phantty reroots its
  own cwd to `$HOME` when launched at the filesystem root, and the
  child PTY falls back to `$HOME` when no explicit cwd is supplied.
- Shells spawned by phantty on macOS now start as login shells (argv[0]
  prefixed with `-`) so `/etc/zprofile` and `~/.zprofile` run and PATH
  picks up `/opt/homebrew/bin`.
- `TERM=xterm-256color`, `COLORTERM=truecolor`, and `TERM_PROGRAM=phantty`
  are now set in every spawned POSIX shell so prompt frameworks and
  line editors render correctly under GUI launches.
- Avoided a double-close of the SCP child stdin pipe that crashed
  uploads under Zig 0.15's stricter `posix.close` path.

## Internal

- Captured the macOS UI port lessons (Metal / AppKit / Zig 0.15 gotchas)
  for future native-platform work.
- Continued the `AppWindow.zig` decoupling effort (B2 / B3 refactors):
  extracted the API wire format, pure agent-history flush scheduler, and
  IME caret pixel placement / stability tracker.
- Added issue templates and a contributing guide.
- Improved Phantty startup crash diagnostics.
