Add adoption-focused examples, contract docs, and CLI polish

docs/host-requirements.md

@@ -0,0 +1,32 @@
+# Host Requirements
+
+`pyro-mcp` currently targets Linux x86_64 hosts.
+
+## Required
+
+- KVM available at `/dev/kvm`
+- support for Firecracker microVMs
+- sufficient disk for the bundled runtime images
+
+## Required For Guest Networking
+
+- `/dev/net/tun`
+- `ip`
+- `nft` or `iptables`
+- host IP forwarding enabled
+- privilege to create TAP devices and NAT rules
+
+The current implementation uses `sudo -n` for host networking commands when a networked run is requested.
+
+## Validate The Host
+
+```bash
+pyro doctor
+```
+
+Check these fields in the output:
+
+- `runtime_ok`
+- `kvm`
+- `networking.tun_available`
+- `networking.ip_forward_enabled`