Refresh release docs for Docker Hub environments

docs/host-requirements.md

@@ -7,6 +7,7 @@
 - KVM available at `/dev/kvm`
 - support for Firecracker microVMs
 - sufficient disk for the embedded runtime files and cached OCI environment images
+- outbound HTTPS access to `registry-1.docker.io` for first-run installs or `pyro env pull`
 
 ## Required For Guest Networking
 

docs/install.md

@@ -4,6 +4,7 @@
 
 - Linux x86_64 host
 - Python 3.12+
+- `uv`
 - `/dev/kvm`
 
 If you want outbound guest networking:
@@ -20,6 +21,12 @@ Run the MCP server directly from the package without a manual install:
 uvx --from pyro-mcp pyro mcp serve
 ```
 
+Prefetch the default official environment:
+
+```bash
+uvx --from pyro-mcp pyro env pull debian:12
+```
+
 Run one command in a curated environment:
 
 ```bash
@@ -38,6 +45,7 @@ uvx --from pyro-mcp pyro env list
 uv tool install pyro-mcp
 pyro --version
 pyro env list
+pyro env pull debian:12
 pyro env inspect debian:12
 pyro doctor
 ```

docs/public-contract.md

@@ -45,9 +45,27 @@ Primary facade:
 
 - `Pyro`
 
-Supported public methods:
+Supported public entrypoints:
 
+- `create_server()`
 - `Pyro.create_server()`
+- `Pyro.list_environments()`
+- `Pyro.pull_environment(environment)`
+- `Pyro.inspect_environment(environment)`
+- `Pyro.prune_environments()`
+- `Pyro.create_vm(...)`
+- `Pyro.start_vm(vm_id)`
+- `Pyro.exec_vm(vm_id, *, command, timeout_seconds=30)`
+- `Pyro.stop_vm(vm_id)`
+- `Pyro.delete_vm(vm_id)`
+- `Pyro.status_vm(vm_id)`
+- `Pyro.network_info_vm(vm_id)`
+- `Pyro.reap_expired()`
+- `Pyro.run_in_vm(...)`
+
+Stable public method names:
+
+- `create_server()`
 - `list_environments()`
 - `pull_environment(environment)`
 - `inspect_environment(environment)`

docs/troubleshooting.md

@@ -7,6 +7,7 @@ Cause:
 - the environment cache directory is not writable
 - the configured registry artifact is unavailable
 - the environment download was interrupted
+- the host cannot reach `registry-1.docker.io`
 
 Fix:
 
@@ -16,6 +17,9 @@ pyro env prune
 pyro env pull debian:12
 ```
 
+If you are validating a freshly published official environment, also verify that the corresponding
+Docker Hub repository is public.
+
 ## `pyro run --network` fails before the guest starts
 
 Cause: