📖 Scribe: Document meshguard connect CLI command

.jules/scribe.md

@@ -12,3 +12,8 @@
 **Gap:** The documentation stated the SWIM protocol period was 1000ms (1s), but the implementation uses 5000ms (5s) in both `src/config.zig` and `src/discovery/swim.zig`.
 **Learning:** The documentation likely reflected an early design decision or standard SWIM defaults, but the implementation settled on a more conservative 5s interval for WAN stability, and docs were not updated.
 **Prevention:** Add a CI check that grep's `docs/guide/configuration.md` for values that match constants exported in `src/config.zig`.
+
+## 2024-05-24 - Missing CLI Commands Documentation
+**Gap:** The `meshguard connect` command (and several others) implemented in `src/main.zig` were missing from the CLI reference documentation (`docs/reference/cli.md`).
+**Learning:** Manual argument parsing in `src/main.zig` combined with manual documentation updates leads to new commands being added to code but forgotten in documentation.
+**Prevention:** Audit `src/main.zig` for `std.mem.eql(u8, command, ...)` statements and cross-reference them with the headings in `docs/reference/cli.md`.

docs/reference/cli.md

@@ -95,6 +95,24 @@ meshguard up [options]
 
 ---
 
+## `meshguard connect`
+
+Direct peer connection via token exchange (bypasses seed nodes).
+
+```bash
+meshguard connect --generate [--in <minutes>]
+meshguard connect --join <mg://token>
+```
+
+**Flow**:
+
+1. Initiator runs `--generate`, shares `mg://` token with peer
+2. Peer runs `--join <token>`, shares response token back
+3. Initiator pastes response token
+4. Both sides punch simultaneously (NTP-synced)
+
+---
+
 ## `meshguard down`
 
 Stop the daemon and remove the `mg0` interface.