tier3: contracts + tests for 12 remaining modules (all 39 files now have Contracts)

org/gateway-tui-main.org

@@ -5,6 +5,20 @@
 
 Event handlers + daemon I/O + main loop.
 
+** Contract
+
+1. (on-key ch): dispatches key presses: Enter triggers send, Backspace
+   deletes, arrows scroll chat. Non-printable keys are ignored.
+2. (on-daemon-msg msg): processes inbound daemon messages. Routes
+   responses to chat display, routes errors to log.
+3. (send-daemon msg): serializes and sends a message to the daemon
+   over the framed TCP protocol.
+4. (handle-return stream): processes the return key: extracts the
+   input buffer, sends to daemon, clears buffer. Handles connection
+   loss gracefully (enqueues error to ~*incoming-msgs*~).
+5. (tui-main): the main loop — connects to daemon, initializes
+   Croatoan windows, runs render/input event loop at ~30fps~.
+
 ** Event Handlers
 #+begin_src lisp
 (in-package :passepartout.gateway-tui)