feat(scum): gate live data on schema evidence

2026-08-11 13:28:36 +08:00
parent e5d26e5420
commit a58da47c60
18 changed files with 1265 additions and 3 deletions
@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://browser.local/schemas/scum-live-data.schema.json",
+  "title": "SCUMLiveDataManifestDeclaration",
+  "type": "object",
+  "required": ["schemaVersion", "probe", "capabilityGates"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "const": "1" },
+    "probe": {
+      "type": "object",
+      "required": ["capability", "targetKey", "bounds"],
+      "additionalProperties": false,
+      "properties": {
+        "capability": { "const": "remote.run.db.sqlite.probe" },
+        "targetKey": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._/-]*$", "maxLength": 120 },
+        "bounds": { "$ref": "#/$defs/probeBounds" }
+      }
+    },
+    "capabilityGates": { "type": "array", "items": { "$ref": "#/$defs/capabilityGate" }, "minItems": 1, "maxItems": 32 }
+  },
+  "$defs": {
+    "probeBounds": {
+      "type": "object",
+      "required": ["maxObjects", "maxColumnsPerObject", "maxIndexesPerObject", "maxForeignKeys", "maxCardinalityReads", "maxSampleRows", "timeoutMs", "maxResultBytes"],
+      "additionalProperties": false,
+      "properties": {
+        "maxObjects": { "type": "integer", "minimum": 1, "maximum": 512 }, "maxColumnsPerObject": { "type": "integer", "minimum": 1, "maximum": 256 }, "maxIndexesPerObject": { "type": "integer", "minimum": 0, "maximum": 128 }, "maxForeignKeys": { "type": "integer", "minimum": 0, "maximum": 128 }, "maxCardinalityReads": { "type": "integer", "minimum": 0, "maximum": 512 }, "maxSampleRows": { "type": "integer", "minimum": 0, "maximum": 3 }, "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 10000 }, "maxResultBytes": { "type": "integer", "minimum": 1, "maximum": 1048576 }
+      }
+    },
+    "capabilityGate": {
+      "type": "object",
+      "required": ["capability", "gate", "adapterVersion", "evidenceStatus", "safeReason"],
+      "additionalProperties": false,
+      "properties": {
+        "capability": { "enum": ["schema-probe", "players.read", "player-details.read", "squads.read", "squad-members.read", "vehicles.read", "flags.read", "positions.read", "profile-xml.write", "economy-command.write", "gift-command.write"] },
+        "gate": { "enum": ["disabled", "enabled"] },
+        "adapterVersion": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$" },
+        "requiredSchemaFingerprint": { "type": "string", "pattern": "^(sha256:)?[a-fA-F0-9]{16,128}$" },
+        "requiredAssetDigests": { "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-fA-F0-9]{64}$" }, "uniqueItems": true, "maxItems": 16 },
+        "evidenceStatus": { "enum": ["missing", "compatible", "incompatible", "failed"] },
+        "safeReason": { "type": "string", "minLength": 1, "maxLength": 240 }
+      }
+    }
+  }
+}