Initial phase 1 baseline implementation

api/openapi.yaml

@@ -3,8 +3,9 @@ info:
   title: Drive v2 API
   version: 0.0.0
   description: >-
-    Contract-first API for Drive v2. Phase 0 contains only foundation and
-    health operations; product endpoints are added with their implementation.
+    Contract-first API for Drive v2. The current Phase 1 persistence foundation
+    exposes only setup status and health operations; product endpoints are added
+    with their implementation.
 servers:
   - url: /
 paths:
@@ -20,6 +21,12 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/SetupStatus"
+        "503":
+          description: Setup state cannot be read because a required dependency is unavailable
+          content:
+            application/problem+json:
+              schema:
+                $ref: "#/components/schemas/Problem"
   /health/live:
     get:
       security: []