Initial release of the oVirt/RHV Engine API simulator.

Stateful FastAPI lab with contract packs, Compose/Helm, Docker Hub release
targets, and Pulumi coverage across all Engine series (GET/POST/PUT/DELETE/HEAD).

app/ovirt/opspec.py

@@ -0,0 +1,40 @@
+"""Contract operation specifications for Engine API packs."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any, Literal
+
+HttpMethod = Literal["GET", "POST", "PUT", "DELETE"]
+
+
+@dataclass(frozen=True)
+class OperationSpec:
+    operation_id: str
+    method: HttpMethod
+    path: str
+    resource_type: str
+    collection_key: str
+    element: str
+    kind: str = "collection"
+    search: bool = False
+    introduced_in: str = "3.0"
+    requires_auth: bool = True
+    status_code: int = 200
+    create_status: int = 201
+    notes: str = ""
+    response_fixture: Any | None = None
+
+
+@dataclass
+class SeriesPack:
+    series: str
+    api_version: str
+    major: int
+    operations: list[OperationSpec] = field(default_factory=list)
+    product: dict[str, str] = field(default_factory=dict)
+    entry_point_links: list[dict[str, str]] = field(default_factory=list)
+    checksum: str = ""
+
+    def operation_count(self) -> int:
+        return len(self.operations)