Referencia

Material de referencia exhaustivo, los hechos que un desarrollador u operador necesita sin narrativa. Seis documentos en esta sección, todos construidos de la misma manera: cada hecho verificado contra el código fuente a partir de la versión que describen.

En esta sección

• Referencia de build.pl, el builder estático: barandillas de invocación, ciclo de vida (staging → checks → manifest → promote), reglas de completo vs incremental, el promotion guard, códigos de salida y la tabla de variables de entorno.
• Referencia de cms.pl, la aplicación del CMS: requisitos de arranque, la estructura de dispatch de admin/API, tareas programadas y los helpers que reutiliza otro tooling.
• Variables de entorno, cada variable CHINASKI_*, su default y su efecto, incluyendo el trío requerido (CHINASKI_SECRET, CHINASKI_DB, CHINASKI_OUTPUT) y los conjuntos específicos de MCP/form-suite.
• Referencia de Settings, cada key de settings por pestaña, con defaults, reglas de validación y cuáles disparan un rebuild (más cuáles no se pueden resetear).
• Referencia de Schema, cada tabla y columna de la base de datos: qué almacena cada una, las restricciones y cómo se relacionan las tablas.
• Referencia de Templates, las variables que recibe cada template de site/block, el inventario de partials y las reglas de seguridad.

Cómo leer estas páginas

Las páginas de referencia son deliberadamente lacónicas, tablas y reglas, sin tutoriales. Si quieres la historia detrás de un hecho (por qué existe el promotion guard, por qué no hay sistema de plugins), la sección Philosophy cubre eso; las secciones Authoring/Admin cubren los workflows.

Convenciones

• Los hechos se declaran como hechos; los casos extremos que merecen bandera están inline en la fila relevante.
• Donde el mismo comportamiento tiene tanto un campo de settings como un control de variable de entorno, ambos se listan con su precedencia (las env vars ganan).
• Los números en la referencia (límites, defaults, timeouts) están verificados contra el código, cuando los docs y el código alguna vez discrepen, confía en el código, y registra una nota para que ambos se corrijan.