From 1e58ecd7f0310a93da800b7ebc22f608b33a7985 Mon Sep 17 00:00:00 2001
From: ReaperOfVeriod <reaperofveriod@gmail.com>
Date: Sun, 25 Oct 2026 04:54:58 +0100
Subject: [PATCH] add server diagnostics contract

---
 contracts/v1/server-diagnostics-response.json | 13 +++++++++++++
 fixtures/v1/server-diagnostics.response.json  |  7 +++++++
 2 files changed, 20 insertions(+)
 create mode 100644 contracts/v1/server-diagnostics-response.json
 create mode 100644 fixtures/v1/server-diagnostics.response.json

diff --git a/contracts/v1/server-diagnostics-response.json b/contracts/v1/server-diagnostics-response.json
new file mode 100644
index 0000000..4d03dc1
--- /dev/null
+++ b/contracts/v1/server-diagnostics-response.json
@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["status", "database", "twitch_identity_count", "unseen_notification_count", "realtime"],
+  "properties": {
+    "status": { "type": "string", "enum": ["healthy"] },
+    "database": { "type": "string", "enum": ["connected"] },
+    "twitch_identity_count": { "type": "integer", "minimum": 0 },
+    "unseen_notification_count": { "type": "integer", "minimum": 0 },
+    "realtime": { "type": "string", "enum": ["available"] }
+  }
+}
diff --git a/fixtures/v1/server-diagnostics.response.json b/fixtures/v1/server-diagnostics.response.json
new file mode 100644
index 0000000..07a3082
--- /dev/null
+++ b/fixtures/v1/server-diagnostics.response.json
@@ -0,0 +1,7 @@
+{
+  "status": "healthy",
+  "database": "connected",
+  "twitch_identity_count": 2,
+  "unseen_notification_count": 0,
+  "realtime": "available"
+}