Publicar Sitio
Conviertes el contenido de una bóveda de gm-apprentice en sitios estáticos compartibles para GMs de TTRPG, alojados en Cloudflare Pages (recomendado para configuraciones nuevas) o GitHub Pages (totalmente compatible). El sitio construido es idéntico en ambos casos; host en vault.config.json (cloudflare-pages o github-pages; si está ausente, significa github-pages) decide cómo se despliega.
Guía a los GMs a través de la configuración, actualizaciones rutinarias y solución de problemas en lenguaje sencillo. La mayoría no son técnicos: explica qué hace npm, git o un comando de terminal en lugar de asumir que lo saben.
Verificación de versión: en la primera invocación ejecuta python3 "${CLAUDE_PLUGIN_ROOT}/skills/shared/scripts/vault_check.py" <vault> version. OK/SETUP → continúa. MISMATCH → anuncia la fila, ejecuta el references/migration-procedure.md de campaign-organizer, luego reanuda. AHEAD → anuncia la fila, dile al GM que actualice el plugin, detente. ERROR → reporta la fila (instalación del plugin rota), detente. Sin fila de veredicto más un error de "not a directory" → pide al GM la ruta correcta de la bóveda.
La herramienta de construcción
Toda la lógica de construcción reside en la herramienta gm-apprentice-publish, que se incluye dentro de este plugin (nunca la instales desde el registro npm, ni repliques su lógica):
<ruta-caché-plugin>/gm-apprentice/<versión-plugin>/tools/publish
<versión-plugin> proviene de .claude-plugin/plugin.json (o de la propia ruta de caché de esta habilidad). Los comandos individuales se ejecutan desde el caché:
TOOL="<ruta-caché-plugin>/gm-apprentice/<versión-plugin>/tools/publish/bin/gm-publish.js"
node "$TOOL" init <dir-destino> # crea un nuevo sitio (se auto-fija a esta versión)
node "$TOOL" update-pin --site <dir> # re-apunta + npm install para un sitio desactualizado (fuera del plugin: añade --tag publish-vX.Y.Z para fijar un tarball de lanzamiento)
node "$TOOL" manifest diff --config <dir>/vault.config.json # clasifica archivos de la bóveda contra el manifiesto
node "$TOOL" manifest apply --config <dir>/vault.config.json ... # edita el manifiesto
node "$TOOL" manifest publish-played --config <dir>/vault.config.json # registra sesiones jugadas
node "$TOOL" deploy --verify --config <dir>/vault.config.json # construye, despliega, prueba la URL
node "$TOOL" doctor --site --config <dir>/vault.config.json # audita la bóveda en busca de defectos de publicación
node "$TOOL" explain "<ruta-relativa-bóveda>" --config <dir>/vault.config.json # cadena de publicación de un archivo
node "$TOOL" --version
node "$TOOL" --help
Antes de cualquier construcción o despliegue que ejecute esta habilidad, ejecuta node "$TOOL" manifest publish-played --config <dir>/vault.config.json tú mismo, para que un sitio nunca se envíe sin una sesión jugada (#277). Marca un índice de sesión revisado solo junto con un Wrap-Up vinculado que se publicará, por lo que el sitio retiene el cuerpo del hub. Omite las entradas Excluidas y no hace nada sin un manifiesto en modo jugador. Reporta las rutas que marcó. Cada otra sesión jugada se lista como "no clara" con su motivo (sin Wrap-Up, Wrap-Up aún no revisado, uno que está Excluido o no se publicará, o un pin de sitio desactualizado). Pregunta al GM una vez, en una sola pregunta enumerándolas con sus motivos. Para una sin Wrap-Up que se publicará, di que su cuerpo de índice se publicará tal como está escrito y sugiere encerrar cualquier nota de Keeper primero. Registra cada una aprobada con manifest publish-played --config <dir>/vault.config.json --session "<índice>" más --include-unreviewed cuando tenga un Wrap-Up (sin revisar, o un pin desactualizado: solo renuncia a la verificación de revisión, así que transmite cualquier motivo que aún dé) o --publish-body cuando no tenga ninguno. Nunca marques un índice de sesión con manifest apply. No los marques en silencio; si el GM dice "todavía no", déjalos y no preguntes de nuevo en esta ejecución. Cuando un motivo dice que el sitio está fijado a una herramienta más antigua, ofrece update-pin --site <dir> primero. La construcción en sí misma permanece de solo lectura en la bóveda, por lo que esto vive en la habilidad, no en build/deploy.
Dentro de un sitio creado, construye con npm (resuelve la herramienta desde el pin file: del sitio creado — sin registro, sin red):
npm install # enlaza la herramienta de construcción fijada (las dependencias se envían empaquetadas)
npm run build # genera docs/ desde la bóveda
# imprime la hoja de un PC — necesita vault.config.json, así que ejecútalo aquí
npx gm-apprentice-publish sheet show --pc <nombre> [--player-safe] [--json]
Se requiere Node 22+; en caso de error de versión, envía al GM a https://nodejs.org (LTS).
Directorio del sitio: las capacidades 2 y 4 leen publish.site_dir de _meta/vault-config.md; un valor relativo es relativo a la bóveda. Si no está establecido, pregunta por la ruta absoluta al repositorio del sitio y ofrece guardarlo allí. Si no hay ningún sitio, no hay nada que registrar, así que omite publish-played.
Nueve Capacidades
1. Configuración inicial
("publicar mi campaña", "configurar un sitio", "quiero que los jugadores vean mi campaña")
Sigue references/setup-wizard.md paso a paso — es la autoridad (preflight doctor primero, Cloudflare por defecto, reanuda desde publish.setup_progress). No improvises ni te saltes pasos.
2. Actualizaciones rutinarias
("actualizar mi sitio", "reconstruir", "he actualizado la bóveda")
- Localiza el directorio del sitio (arriba).
node "$TOOL" update-pin --site <dir>— reporta su única línea.node "$TOOL" manifest diff --config <dir>/vault.config.json. Si lista archivos Nuevos/Eliminados, preséntalos; después de que el GM confirme,node "$TOOL" manifest apply --config <dir>/vault.config.json --publish <ruta>... --exclude "<ruta>=<motivo>"... --prune. Deja los índices de sesiones jugadas fuera de--publish:publish-played(arriba) los registra.node "$TOOL" deploy --verify --config <dir>/vault.config.json— transmite su línea final textualmente. En una salida no cero, ve a la capacidad 3. Las credenciales faltantes de Cloudflare son explicadas en línea pordeploy; para configurarlas directamente, ejecutanode "$TOOL" doctor --set-cloudflare-creds.
3. Solución de problemas
(mensajes de error, "la construcción falló", "los retratos no se muestran", "falta una página", "los enlaces están rotos")
Ejecuta node "$TOOL" doctor --site --config <dir>/vault.config.json primero; para una página faltante, node "$TOOL" explain "<ruta-relativa-bóveda>". Luego usa references/troubleshooting.md: nombra el modo de fallo, explica la causa claramente, guía la solución paso a paso y ofrece aplicarla.
4. Migraciones de esquema
("añadí un nuevo tipo de entidad", "campaign-organizer fue actualizado", "nueva carpeta en la bóveda", "faltan páginas después de una actualización")
- Localiza el directorio del sitio y lee su
vault.config.json. - Compara
folderMapcon las carpetas de la bóveda; propone adiciones afolderMap/excludeDirs. - Aplica después de la confirmación, luego
npm run buildpara confirmar. - Di brevemente cómo se renderiza el nuevo tipo (plantilla dedicada o fallback de wiki inteligente —
references/schema-reference.md).
5. Gestión multi-sitio
("tengo dos campañas", "actualizar todos mis sitios")
Rastrea cada ruta de repositorio de sitio y su ruta de bóveda en la conversación, ofrece recorrer actualizaciones rutinarias sobre todos ellos y confirma cada sitio antes de empujar.
6. Filtrado de contenido
("publicar solo contenido de jugador", "ocultar notas del GM", "qué verán los jugadores", "publicar sin spoilers")
Lee references/content-filtering.md § Modelo de Visibilidad de Contenido y § Formato de Manifiesto. En mode: player, un archivo se publica solo como una entrada marcada bajo ## Publishing; marcarlo bajo ## Excluded o ## Needs Decision no lo publica; mode: full ignora el manifiesto.
- Lee
_meta/vault-config.md. Sin una secciónpublish:, primero sigue el Flujo de Preguntas de Configuración de content-filtering.md (tema, imagen, 404) y escribe la configuración inicial. Confirma quemodeesplayer— si esfull, detente y pide al GM que lo cambie antes de construir el manifiesto. - Categoriza cada archivo de la bóveda según el modelo de visibilidad y escribe
_meta/publish-manifest.md. - Resume, luego guía al GM a través de los elementos ambiguos, registrando cada decisión en el manifiesto (marcado bajo
## Publishing, o movido a## Excludedcon un motivo).
Las publicaciones posteriores recogen archivos nuevos y eliminados a través del diff de manifiesto de la capacidad 2.
7. Bucle de solicitudes de cambio (en la mesa)
("inicia tu bucle de verificación", "recoge las solicitudes de cambio", "abre la bandeja de entrada", "vigila cambios en las hojas")
Sigue references/change-request-loop.md — un bucle desatendido y auto-gestionado que aplica ediciones limpias de hojas de jugador (GURPS 4e y CoC 7e) y señala casos extremos.
8. Configuración de barra de estado en vivo (Tier 2a) / 9. Configuración de bandeja de entrada en la mesa (Tier 2b)
("activar la barra de estado", "dejar que los jugadores actualicen HP/FP en vivo" / "configurar la bandeja de entrada", "dejar que los jugadores envíen cambios")
Solo Cloudflare Pages. Desde el directorio del sitio ejecuta node "$TOOL" setup-status-bar o node "$TOOL" setup-inbox (--config <ruta> si no es ./vault.config.json). Ambos están protegidos por verificación previa, son idempotentes y manejan KV ellos mismos — ver references/cloudflare-pages.md § La forma rápida. setup-inbox es solo infraestructura; la sesión en la mesa es la capacidad 7.
Referencias
references/configuration.md— todos los ajustes._meta/vault-config.md(filtrado, tematización) prevalece sobrevault.config.json(rutas, URLs, visualización) cuando ambos configuran algo.references/schema-reference.md— qué campos renderiza cada tipo de entidad.references/cloudflare-pages.md— token de Cloudflare, credenciales (doctor --set-cloudflare-creds), primer despliegue, dominios personalizados.references/github-pages.md— habilitación manual de GitHub Pages. Ambos hosts pueden ejecutarse en paralelo desde la mismadocs/.
Habilidades Complementarias
campaign-organizer crea la estructura de la bóveda que esta habilidad lee — las páginas faltantes o las discrepancias de esquema generalmente se rastrean hasta ella. Para contenido nuevo, envía al GM a ttrpg-expert, luego reconstruye. Una pasada de campaign-qa antes de publicar mantiene los enlaces rotos fuera del sitio en vivo.
Copyright
Los sitios publicados son públicos. Antes de publicar, recuerda al GM que el contenido de TTRPG con licencia en la bóveda debe permanecer dentro de su licencia (ver ATTRIBUTION.md en el repositorio de gm-apprentice). Nunca pongas texto de reglas con licencia en páginas generadas; si una nota de la bóveda contiene texto de reglas textual, márcalo para que el GM lo parafrasee.