add bot secrets contract

contracts/v1/bot-secrets-response.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://trixie.reaperofveriod.nl/contracts/v1/bot-secrets-response.json",
+  "title": "Trixie bot secret metadata",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["id", "name", "description", "used_by", "created_at", "updated_at"],
+    "properties": {
+      "id": { "type": "string", "format": "uuid" },
+      "name": { "type": "string", "pattern": "^[A-Za-z0-9_]+$" },
+      "description": { "type": "string" },
+      "used_by": { "type": "array", "items": { "type": "string" } },
+      "created_at": { "type": "string", "format": "date-time" },
+      "updated_at": { "type": "string", "format": "date-time" }
+    }
+  }
+}

fixtures/v1/bot-secrets.response.json

@@ -0,0 +1,10 @@
+[
+  {
+    "id": "00000000-0000-4000-8000-000000000002",
+    "name": "API_Key",
+    "description": "External API key",
+    "used_by": [],
+    "created_at": "2026-01-01T00:00:00Z",
+    "updated_at": "2026-01-01T00:00:00Z"
+  }
+]