Las reglas con las que se revisa cada escritura, el veredicto que entregan y el catálogo de reglas que activa una colección.

Contratos

Un contrato es una regla sobre una entrada. Hollware ejecuta los contratos de una colección en cada escritura, y de nuevo al publicar, y entrega un veredicto.

El veredicto

{
  "ok": false,
  "phase": "write",
  "errors": [
    {
      "contract": "schema",
      "severity": "error",
      "path": "/frontmatter/description",
      "message": "Too big: expected string to have <=160 characters",
      "fix": "Shorten the description to 160 characters or fewer."
    }
  ],
  "warnings": []
}

Cada infracción tiene un path (un JSON Pointer dentro de la entrada), un message y un fix: un agente puede actuar sobre ella sin leer tu código.

Una escritura nunca falla por un contrato

Un borrador que no cumple un contrato se guarda, con el veredicto. El trabajo en curso nunca se pierde, y el agente lo corrige con update_draft. Lo que un contrato detiene es la publicación:

un error bloquea publish, que responde blocked;
una advertencia pide confirmación: publish responde needs_acknowledgement con las advertencias, y publica cuando se devuelven en acknowledgeWarnings.

validate ejecuta los contratos sobre un Markdown sin guardar nada.

Incluidos

Estos se ejecutan siempre: el esquema del frontmatter, los componentes y sus props, la seguridad del contenido (nada de HTML crudo que ejecute scripts) y el límite de tamaño de una entrada.

El catálogo

Una colección activa más reglas del catálogo, cada una con una severidad (un error bloquea la publicación; una advertencia hay que confirmarla) y sus parámetros. Agrégalas en el admin, en la página de la colección, o por MCP con set_collection; get_structure lista el catálogo con el JSON Schema de los parámetros de cada regla.

Regla	Revisa	Parámetros
`translation-pair`	que la entrada exista en cada locale de su grupo de traducción, para publicar	ninguno
`internal-links-resolve`	que los enlaces a otras entradas apunten a entradas publicadas, al publicar	ninguno
`images-have-alt`	que cada imagen tenga texto alternativo	ninguno
`field-length`	que un campo de texto tenga entre `min` y `max` caracteres, o una lista entre `min` y `max` elementos	`field`, `min`, `max`, `unless`
`field-pattern`	que un campo de texto calce completo con una expresión regular	`field`, `pattern`, `description`
`required-to-publish`	campos que un borrador puede dejar vacíos y que una entrada publicada debe llenar	`fields`
`banned-words`	palabras que no pueden aparecer ni en un campo de texto ni en el cuerpo	`words`, `reason`
`reference`	cada slug que nombra un campo es una entrada de otra colección, que debe estar publicada para publicar	`field`, `collection`, `locale`

Un título de 60 caracteres como máximo, salvo que haya un seoTitle, es una sola regla:

{
  "rule": "field-length",
  "severity": "warning",
  "params": { "field": "title", "max": 60, "unless": "seoTitle" },
  "id": "seo-title-length"
}

Una entrada puede nombrar otras por su slug, como el autor de un post, una serie o el evento de una charla. La regla reference revisa los slugs de un campo (uno, o una lista) contra una colección, en el locale de la entrada o en el locale que le des:

{ "rule": "reference", "severity": "error", "params": { "field": "author", "collection": "authors" } }

Un sitio las lee junto con la entrada: get_entry con references: true (o getEntry(…, { references: true }), o ?references=true por HTTP) responde references, las entradas publicadas que nombra cada campo, en su orden.

id nombra la regla en los veredictos; dale uno cuando una colección tenga la misma regla dos veces. Cada infracción trae un fix escrito para el agente que la lee: qué hacer, no qué salió mal.