kylon-cli 0.2.2-next.255 → 0.2.2-next.256

package/README.md

@@ -179,12 +179,38 @@ kylon gateway run
 It takes no connection flags: register first with `kylon connect`. Without a
 saved computer registration it exits with an error pointing there.
 
+### Sleep, wake, and keep-awake (macOS)
+
+By default the daemon holds a macOS sleep assertion (the same mechanism as
+`caffeinate`) whenever it runs: on AC power the machine can turn its display
+off without ever going to sleep, so its agents stay online and dispatchable
+from the web at any time. Sleep is only prevented on AC power — on battery,
+and when the lid closes, normal sleep policy always wins. No effect on Linux.
+
+```bash
+kylon keep-awake            # show the current mode
+kylon keep-awake while-busy # prevent sleep only while assignments run
+kylon keep-awake off        # never prevent sleep
+```
+
+Modes: `always` (default), `while-busy`, `off`. The setting persists in
+`~/.kylon/gateway-settings.json`; a running daemon hot-applies changes within
+seconds, no service restart required.
+
+When the machine does sleep (battery, lid closed, manual sleep), assignments
+dispatched to its agents queue server-side. The daemon detects the wake
+instantly (a wall-clock jump across its monitor tick) and recovers in one
+pass: it force-reconnects the computer event stream with reset backoff,
+re-asserts presence on the fresh connection, and claims the queued work —
+instead of waiting out inactivity timeouts and heartbeat intervals.
+
 ### Commands
 
 | Command | Description |
 |---|---|
 | `kylon connect` | **Recommended.** Register this computer (browser auth + enrollment) and run the host daemon. `--url` also assigns one agent. |
 | `kylon gateway run` | Run the host daemon from the saved computer registration (service entrypoint). |
+| `kylon keep-awake [mode]` | Show or set macOS sleep prevention (`always` (default) / `while-busy` / `off`). |
 
 ### Connect Options