Add docstrings and fix pony-lint violations (#18)

Add docstrings to all public methods on close code types
(CloseNormal, CloseGoingAway, etc.), close status types
(CloseNoStatusReceived, CloseAbnormalClosure, OtherCloseCode),
and handshake error types.

Fix pony-lint violations: rename files to match principal type
naming convention (_mort.pony -> _unreachable.pony, websocket_*.pony
-> web_socket_*.pony), fix two lines exceeding 80 columns.

Author: SeanTAllen

CLAUDE.md

@@ -19,7 +19,7 @@ make build-examples ssl=3.0.x # Just examples
 Import aliases used consistently across the codebase:
 - `use lori = "lori"`
 - `use crypto = "ssl/crypto"`
-- `use ssl_net = "ssl/net"` (only in `websocket_server.pony`)
+- `use ssl_net = "ssl/net"` (only in `web_socket_server.pony`)
 - `use "encode/base64"` (unqualified)
 
 ## Architecture
@@ -58,13 +58,13 @@ _Handshaking → _Open → _Closing → _Closed
 | `_close_status_extractor.pony` | `_CloseStatusExtractor` | Extracts `(CloseStatus, String val)` from raw close frame payload |
 | `_utf8_validator.pony` | `_Utf8Validator` | UTF-8 byte sequence validation |
 | `_connection_state.pony` | `_ConnectionState` | State machine trait + four state classes |
-| `_mort.pony` | `_Unreachable` | Crash-on-bug helper for impossible code paths |
+| `_unreachable.pony` | `_Unreachable` | Crash-on-bug helper for impossible code paths |
 
 ## Naming Conventions
 
 - `_` prefix on type names = package-private (visible within `mare/` package, not to consumers)
 - `_` prefix on members = type-private (only accessible within the defining type)
-- File names match the primary type they contain (e.g., `websocket_server.pony` contains `WebSocketServer`)
+- File names match the primary type they contain (e.g., `web_socket_server.pony` contains `WebSocketServer`)
 
 ## Test Patterns
 

mare/_test_frame_encoder.pony

@@ -152,7 +152,8 @@ class \nodoc\ iso _TestFrameEncoderPropertyRoundtrip is Property1[USize]
 
     // To parse through _FrameParser, we need to mask the frame
     // (client-to-server). Build a masked version.
-    let mask_key: Array[U8] val = recover val [as U8: 0x37; 0xFA; 0x21; 0x3D] end
+    let mask_key: Array[U8] val =
+      recover val [as U8: 0x37; 0xFA; 0x21; 0x3D] end
     let masked = _mask_frame(frame, mask_key)?
 
     // Parse

mare/_mort.pony mare/_unreachable.ponymare/_mort.pony renamed to mare/_unreachable.pony

@@ -108,9 +108,10 @@ Override any of these on your `WebSocketServerActor`:
 - `on_open(request)` — connection established
 - `on_text_message(data)` — complete text message received
 - `on_binary_message(data)` — complete binary message received
-- `on_closed(close_status, close_reason)` — connection closed; `close_status`
-  is a `CloseStatus` indicating why (e.g., `CloseNormal`, `CloseAbnormalClosure`),
-  `close_reason` is the UTF-8 reason string from the close frame (or empty)
+- `on_closed(close_status, close_reason)` — connection closed;
+  `close_status` is a `CloseStatus` indicating why
+  (e.g., `CloseNormal`, `CloseAbnormalClosure`), `close_reason` is
+  the UTF-8 reason string from the close frame (or empty)
 - `on_throttled()` / `on_unthrottled()` — backpressure signals
 
 ## Sending Messages