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

src/pyro_mcp/contract.py

@@ -0,0 +1,41 @@
+"""Public contract constants for the CLI, SDK, and MCP server."""
+
+from __future__ import annotations
+
+PUBLIC_CLI_COMMANDS = ("mcp", "run", "doctor", "demo")
+PUBLIC_CLI_DEMO_SUBCOMMANDS = ("ollama",)
+PUBLIC_CLI_RUN_FLAGS = (
+    "--profile",
+    "--vcpu-count",
+    "--mem-mib",
+    "--timeout-seconds",
+    "--ttl-seconds",
+    "--network",
+)
+
+PUBLIC_SDK_METHODS = (
+    "create_server",
+    "create_vm",
+    "delete_vm",
+    "exec_vm",
+    "list_profiles",
+    "network_info_vm",
+    "reap_expired",
+    "run_in_vm",
+    "start_vm",
+    "status_vm",
+    "stop_vm",
+)
+
+PUBLIC_MCP_TOOLS = (
+    "vm_run",
+    "vm_list_profiles",
+    "vm_create",
+    "vm_start",
+    "vm_exec",
+    "vm_stop",
+    "vm_delete",
+    "vm_status",
+    "vm_network_info",
+    "vm_reap_expired",
+)