repo-mailbox/docs
Kjell Tore Guttormsen 4080e22abd docs(ghostty): a ghost surface is detectable in one property read
The measurement identified realized surfaces by counting shell processes, which
is what was available while probing. morning-driver, building against this
document, found a cheaper and stronger test in the sdef: `working directory` is
readable on a terminal, and a surface with no shell process reports it EMPTY -
exactly the ghost signature the broken creation API produces.

That turns "has this surface been realized" from an inference into a
machine-checkable question, which is the guard anything driving Ghostty needs
before it types into a pane.

The same property answers one of the document's own open questions: it goes
empty when a shell exits and returns when the prompt is back, so "has this pane
returned to a prompt" can be polled rather than guessed at with a delay.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011eKRzhD1RqY2MxvDEkrJAM
2026-08-02 15:57:27 +02:00
..
2026-07-25-cross-repo-delivery-research.md fix(engine)!: identity is derived, never invented 2026-07-25 20:34:43 +02:00
2026-07-25-monitoring-reduction-survey.md fix(engine)!: identity is derived, never invented 2026-07-25 20:34:43 +02:00
ghostty-orchestration-measurement.md docs(ghostty): a ghost surface is detectable in one property read 2026-08-02 15:57:27 +02:00