Version the common and derived rail contract

schemas/derived-rail-v1.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://railiance.dev/schemas/derived-rail-v1.schema.json",
+  "title": "Railiance derived rail declaration",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "kind",
+    "rail_id",
+    "ownership_repo",
+    "contract_version",
+    "composition_kind",
+    "base_rail",
+    "base_rail_contract",
+    "execution_architecture",
+    "required_substrate_capabilities",
+    "inherited_semantics",
+    "overridden_semantics",
+    "compatibility_constraints",
+    "readiness_state"
+  ],
+  "properties": {
+    "kind": {"const": "execution-rail"},
+    "rail_id": {"type": "string", "pattern": "^rail-[a-z0-9-]+$"},
+    "ownership_repo": {"type": "string"},
+    "contract_version": {"type": "string"},
+    "composition_kind": {"const": "derived"},
+    "base_rail": {"const": "rail-kubernetes"},
+    "base_rail_contract": {"const": "1.0.0"},
+    "execution_architecture": {"type": "string"},
+    "required_substrate_capabilities": {
+      "type": "array",
+      "minItems": 1,
+      "items": {"type": "string"},
+      "uniqueItems": true
+    },
+    "inherited_semantics": {
+      "type": "array",
+      "minItems": 1,
+      "items": {"type": "string"},
+      "uniqueItems": true
+    },
+    "overridden_semantics": {
+      "type": "array",
+      "minItems": 1,
+      "items": {"type": "string"},
+      "uniqueItems": true
+    },
+    "compatibility_constraints": {"type": "array", "items": {"type": "string"}},
+    "readiness_state": {
+      "enum": ["declared", "installed", "verified", "production-approved", "deprecated"]
+    }
+  }
+}