Add a stateful Proxmox API console and broad handler coverage beyond the

initial QEMU slice, backed by imported contracts for majors 6–9.
- Implement durable handlers for access/auth, cluster, LXC, storage, HA,
  firewall, Ceph, SDN, ACME, notifications, pools, mapping, and node ops
- Serve an interactive Web UI with catalog browsing, demo seed controls,
  and OpenAPI/help surfaces
- Bundle PVE 6.4-15, 7.4-16, and 8.4.5 contract revisions alongside 9.2.3
- Support in-memory runtime contract Apply (POST /ui/api/contract/apply)
  so /version and /api2 routes follow the selected major until restart
- Expand seed profiles (including demo-cluster), migrations 007–008, TLS
  gateway config, Compose/Makefile tooling, and compatibility evidence
- Tighten .gitignore for macOS, hidden directories (.*/), and local secrets

examples/README.md

@@ -0,0 +1,27 @@
+# Runnable client cookbooks
+
+Companion code for [docs/clients.md](../docs/clients.md).
+
+## Prerequisites
+
+```bash
+make up
+make seed PROFILE=small
+```
+
+## Layout
+
+| Path | Stack |
+|---|---|
+| `python/` | proxmoxer + requests |
+| `go/` | Go stdlib |
+| `java/` | Java 11+ HttpClient |
+| `perl/` | HTTP::Tiny |
+| `ansible/` | ansible-playbook |
+| `terraform/` | Terraform + Proxmox provider |
+| `pulumi/` | Pulumi (Python) |
+
+Default node: **`pve01`**. Default token:
+`root@pam!automation=automation-secret`.
+
+Guides: [docs/examples/](../docs/examples/overview.md).