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

app/config.py

@@ -35,11 +35,23 @@ class Settings(BaseSettings):
     contract_snapshot: Path | None = None
     compatibility_evidence: Path | None = None
     contract_fallback: Literal["error", "schema-default", "fixture"] = "error"
+    catalog_artifact_url_6: str = "https://pve.proxmox.com/pve-docs-6/api-viewer/apidoc.js"
+    catalog_artifact_url_7: str = "https://pve.proxmox.com/pve-docs-7/api-viewer/apidoc.js"
+    catalog_artifact_url_8: str = "https://pve.proxmox.com/pve-docs-8/api-viewer/apidoc.js"
+    catalog_artifact_url_9: str = "https://pve.proxmox.com/pve-docs/api-viewer/apidoc.js"
     ticket_signing_key: SecretStr = SecretStr("development-only-signing-key-change-me")
     task_worker_concurrency: int = Field(default=2, ge=1, le=32)
     task_lease_seconds: float = Field(default=30.0, gt=1, le=300)
     simulation_time_scale: float = Field(default=10.0, gt=0, le=10000)
 
+    def catalog_artifact_urls(self) -> dict[int, str]:
+        return {
+            6: self.catalog_artifact_url_6,
+            7: self.catalog_artifact_url_7,
+            8: self.catalog_artifact_url_8,
+            9: self.catalog_artifact_url_9,
+        }
+
 
 @lru_cache(maxsize=1)
 def get_settings() -> Settings: