From 96941c6dbc55ee6a7625bd2827461730f37d3d47 Mon Sep 17 00:00:00 2001
From: Lawrence Chen <54008264+lawrencecchen@users.noreply.github.com>
Date: Wed, 28 Jan 2026 23:19:17 -0800
Subject: [PATCH] Document Ghostty fork changes

---
 docs/ghostty-fork.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 docs/ghostty-fork.md

diff --git a/docs/ghostty-fork.md b/docs/ghostty-fork.md
new file mode 100644
index 00000000..18d3c205
--- /dev/null
+++ b/docs/ghostty-fork.md
@@ -0,0 +1,36 @@
+# Ghostty Fork Changes (manaflow-ai/ghostty)
+
+This repo uses a fork of Ghostty for local patches that aren't upstream yet.
+When we change the fork, update this document and the parent submodule SHA.
+
+## Fork update checklist
+
+1) Make changes in `ghostty/`.
+2) Commit and push to `manaflow-ai/ghostty`.
+3) Update this file with the new change summary + conflict notes.
+4) In the parent repo: `git add ghostty` and commit the submodule SHA.
+
+## Current fork changes
+
+### 1) OSC 99 (kitty) notification parser
+
+- Commit: `4713b7e23` (Add OSC 99 notification parser)
+- Files:
+  - `src/terminal/osc.zig`
+  - `src/terminal/osc/parsers.zig`
+  - `src/terminal/osc/parsers/kitty_notification.zig`
+- Summary:
+  - Adds a parser for kitty OSC 99 notifications and wires it into the OSC dispatcher.
+
+## Merge conflict notes
+
+These files change frequently upstream; be careful when rebasing the fork:
+
+- `src/terminal/osc/parsers.zig`
+  - Upstream uses `std.testing.refAllDecls(@This())` in `test {}`.
+  - Ensure `iterm2` import stays, and keep `kitty_notification` import added by us.
+
+- `src/terminal/osc.zig`
+  - OSC dispatch logic moves often. Re-check the integration points for the OSC 99 parser.
+
+If you resolve a conflict, update this doc with what changed.