agent-rule-v1

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://agent-atoms.com/schemas/rule-v1.json",
  "title": "agent-atoms v1 rule",
  "description": "A rule constrains how atoms and compositions can be combined. Examples: capability-grant, isolation-rule, communication-pattern, supervision-hierarchy.",
  "type": "object",
  "required": ["schema", "type", "id", "version", "name", "predicate", "effect"],
  "additionalProperties": false,
  "properties": {
    "schema": { "type": "string", "const": "https://agent-atoms.com/schemas/rule-v1.json" },
    "type": {
      "type": "string",
      "enum": ["capability-grant", "isolation-rule", "communication-pattern", "supervision-hierarchy"]
    },
    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$" },
    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[A-Za-z0-9.-]+)?$" },
    "name": { "type": "string", "minLength": 1, "maxLength": 80 },
    "description": { "type": "string", "maxLength": 500 },
    "tags": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 40 }, "uniqueItems": true },
    "predicate": {
      "type": "object",
      "required": ["subject_ref", "condition", "value"],
      "additionalProperties": false,
      "properties": {
        "subject_ref": { "type": "string", "pattern": "^agent-atoms://(atoms|agents|rules)/[a-z-]+(?:/[a-z0-9-]+)?$" },
        "condition": { "type": "string", "enum": ["eq", "neq", "in", "not_in", "gte", "lte", "matches"] },
        "value": {}
      }
    },
    "effect": { "type": "string", "enum": ["require", "forbid", "warn"] },
    "rationale": { "type": "string", "maxLength": 500 }
  }
}