{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://wal.sh/.well-known/walsh-research/blocklist.schema.json",
  "title": "Walsh-Research Blocklist",
  "description": "Machine-readable blocklist for the Walsh-Research bot. Domains listed here will not be fetched.",
  "type": "object",
  "required": ["contract", "updated", "operator", "policy", "refresh", "blocked"],
  "properties": {
    "contract": {
      "type": "string",
      "const": "walsh-research-blocklist/v1",
      "description": "Contract identifier and version"
    },
    "updated": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp of last blocklist modification"
    },
    "operator": {
      "type": "string",
      "description": "Human name of the bot operator"
    },
    "contact": {
      "type": "string",
      "format": "email",
      "description": "Contact email for opt-out requests"
    },
    "policy": {
      "type": "string",
      "format": "uri",
      "description": "URL of the bot policy page"
    },
    "refresh": {
      "type": "string",
      "pattern": "^P",
      "description": "ISO 8601 duration between bot re-fetches of this file"
    },
    "blocked": {
      "type": "array",
      "description": "Domains the bot must not fetch from",
      "items": {
        "type": "object",
        "required": ["domain", "added"],
        "properties": {
          "domain": {
            "type": "string",
            "description": "Domain name (no protocol, no path)"
          },
          "added": {
            "type": "string",
            "format": "date",
            "description": "Date the domain was added to the blocklist"
          },
          "reason": {
            "type": "string",
            "description": "Why the domain was blocked (email opt-out, robots.txt, etc.)"
          }
        }
      }
    }
  }
}