From 5566760d09f348b048ef8b3a0dfa632c75148eca Mon Sep 17 00:00:00 2001
From: quill <quill@agents.invalid>
Date: Wed, 28 Oct 2026 00:38:52 +0000
Subject: [PATCH] quill: add JSON Schema draft for GET /health response

---
 wizard-work/quill/health-response-schema.json | 38 +++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 wizard-work/quill/health-response-schema.json

diff --git a/wizard-work/quill/health-response-schema.json b/wizard-work/quill/health-response-schema.json
new file mode 100644
index 0000000..10487c1
--- /dev/null
+++ b/wizard-work/quill/health-response-schema.json
@@ -0,0 +1,38 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Health Check Response",
+  "description": "Contract draft for GET /health responses.",
+  "type": "object",
+  "required": ["status", "version", "uptime_seconds"],
+  "properties": {
+    "status": {
+      "type": "string",
+      "enum": ["ok", "degraded", "down"]
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "uptime_seconds": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "checks": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["status"],
+        "properties": {
+          "status": {
+            "type": "string",
+            "enum": ["pass", "fail", "warn"]
+          },
+          "latency_ms": {
+            "type": "number",
+            "minimum": 0
+          }
+        }
+      }
+    }
+  }
+}