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

docs/examples/python-proxmoxer.md

@@ -0,0 +1,21 @@
+# Python — proxmoxer
+
+Canonical library path against the HTTPS gateway.
+
+## Run
+
+```bash
+make up && make seed PROFILE=small
+pip install -r examples/python/requirements.txt
+python examples/python/proxmoxer_cookbook.py
+```
+
+Environment overrides: `PVE_HOST` (default `localhost`), `PVE_PORT` (default
+`8007`), `PVE_USER`, `PVE_PASSWORD`, or token via `PVE_TOKEN_NAME` /
+`PVE_TOKEN_VALUE`.
+
+## Notes
+
+- `verify_ssl=False` is required only for the disposable local certificate.
+- Ticket mutations handled by proxmoxer include CSRF automatically.
+- Default node for `small` is `pve01`.