Files
tty7/crates
l0ng-ai 43961cae20 docs: restore seven invariants that the comment strip took out
#268 ("strip every comment from the Rust sources") removed 38,164
comment lines. Much has been rewritten since, but 7,587 blocks still sit
in front of code that is unchanged and now undocumented. Last commit I
started implementing a pair of deliberate no-op stubs before `git log -L`
turned up the stripped comment saying they were deliberate — which is
the failure mode this class of loss produces.

Seven restored here, chosen for documenting why something must not
change rather than what it does:

- `LinkShutdown` — "not optional politeness; without it a client cannot
  be closed". A reader parked in a blocking read is not woken by any
  flag, so closing has to act on the fd, and no std trait spans the
  transports. Nothing else says this.
- `peek_frame_kind` / `is_error_kind` — why Attach is classified before
  the payload is paid for.
- `FontFeatures` — a frozen config key deliberately replicating
  gpui's type so tty7-core parses without linking gpui.
- `desired_tabs` / `every_leaf_is_native_ssh` — held vs
  permanently-invisible tabs, and why conflating them either deletes a
  daemon tab mid-revival or freezes a window's ordering forever.
- `control_for` / `TreeLink` / `classify_tree_link` — local and remote
  links unified, and unserved as a fact about the peer rather than a
  transient down.

Restored against the current code, not verbatim: three claims had gone
stale and are corrected. `Duplex` has since adopted `LinkShutdown`
(`Halves` carries one) rather than needing to; `peek_frame_kind` has two
callers now, not one; and `gpui_font_features` moved out of `ui::app`.
2026-08-16 05:28:01 +08:00
..