Initial commit: VMware vSphere API simulator scaffold.

Add the FastAPI app, PostgreSQL migrations, Docker/Helm packaging, API
contracts, docs, client examples, and the unit/integration/compatibility
test suite for local client and tooling labs without a real vCenter.

scripts/run_vsphere_full_green.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")/.."
+
+export PYTHONPATH=/workspace
+export VSPHERE_BASE="${VSPHERE_BASE:-http://simulator:8080}"
+
+echo "== pytest =="
+python -m pytest \
+  tests/unit/test_vsphere_universe.py \
+  tests/unit/test_vsphere_matrix.py \
+  tests/unit/test_vsphere_compatibility.py \
+  tests/unit/test_vsphere_catalog.py \
+  tests/unit/test_vsphere_profiles.py \
+  tests/unit/test_vsphere_mappers.py \
+  tests/unit/test_property_collector.py \
+  tests/unit/test_web_assets.py \
+  tests/unit/test_web_console.py \
+  tests/integration/test_vsphere_api_surface_data.py \
+  tests/integration/test_vsphere_api.py \
+  tests/integration/test_vsphere_soap_depth.py \
+  tests/integration/test_vsphere_full_api.py \
+  -q
+
+echo "== surface =="
+python scripts/vsphere_surface_probe.py
+
+echo "== matrix =="
+python scripts/vsphere_full_matrix_probe.py
+
+echo "== real-data spotcheck =="
+python scripts/vsphere_real_data_spotcheck.py
+
+echo "ALL GREEN"