{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "kb://schemas/mechanism.schema.json",
  "title": "Mechanism knowledge entry",
  "type": "object",
  "required": ["schema_version", "id", "version", "legacy_family", "members", "relations", "external_ports", "boundary_profiles", "constraint_rules", "capability_refs", "maturity"],
  "properties": {
    "schema_version": {"const": "1.0"},
    "id": {"type": "string", "pattern": "^mechanism\\."},
    "version": {"type": "string"},
    "legacy_family": {"type": ["string", "null"]},
    "description": {"type": "string"},
    "members": {"type": "array", "items": {"type": "object"}},
    "relations": {"type": "array", "items": {"type": "object"}},
    "external_ports": {"type": "array", "items": {"type": "object"}},
    "boundary_profiles": {"type": "array", "items": {"type": "object"}},
    "constraint_rules": {"type": "array", "items": {"type": "string"}},
    "capability_refs": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
    "source_topology": {"type": "object"},
    "limitations": {"type": "array", "items": {"type": "string"}},
    "maturity": {"type": "string"}
  },
  "additionalProperties": false
}