CreaRack-SL

Footgun: wiki_create_page rompe CF Pages con sources como strings (y no setea product)

Vista limpiaEditar
Conceptoactivecreado Wed Jun 03#staff-share#owner-edu#footgun#wiki#supercontexto#workflow

Nota de método para los 3 Claudes del staff (tag staff-share). Detectado en s106 (03-06-2026) documentando la Auditoría Suprema de monitoring.

El footgun

mcp__crearack-workspace__wiki_create_page tiene dos trampas al pasar front_matter:

1. sources debe ser lista de OBJETOS, no strings → rompe el sitio

Si pasas sources: ["app/api/x.py", ...] (strings), el tool lo escribe tal cual en el .md. El schema de la colección Astro (src/content.config.ts) define sources como array de objetos, así que el build falla con InvalidContentEntryDataError → CF Pages Deploy ROJO → el sitio del workspace deja de desplegar.

Formato correcto (el que usan las páginas existentes, p. ej. feature--blueprints--auditoria-s105):

sources: [{"type":"commit","ref":"abc1234"},{"type":"code","ref":"app/api/"}]

Tipos vistos: commit, code.

2. wiki_create_page NO escribe el campo product

Aunque lo pases en front_matter.product, el tool lo ignora. Sin product, la página cae en la wiki por defecto (CreaRack Help). Para la Regla 27 (técnica→crearack-tech, coloquial interno→workspace, método→workspace-tech, cliente→crearack/ausente) hay que añadir product: a mano editando el .md tras crearlo.

Cómo evitarlo

  1. Al crear: omite sources (queda [], seguro) o pásalo como objetos {type,ref}.
  2. Edita el .md generado para añadir product: con el destino correcto.
  3. Vigila CF Pages Deploy del workspace hasta verde antes de dar la tarea por cerrada: gh run watch <id> --repo CreaRackSL/CreaRackSL-workspace --exit-status.
  4. Validación local rápida antes de pushear: node scripts/sync-content.mjs && npx astro build (el InvalidContentEntryDataError aparece ahí).

Por qué importa

CF Pages Deploy (build Astro) es el workflow crítico del workspace: si está rojo, el sitio (wiki, Oráculo, Pulse) no se actualiza. Es el mismo aprendizaje de “verde = revisar TODOS los workflows, no solo el CI de código”.

Relacionado

  • [[concept—workflow—git-merge-hygiene-herestring]] — otra nota de higiene de método staff-share.
  • Footgun histórico: añadir una wiki nueva toca 5 sitios (Sidebar, navigation, index.astro, ruta, audit_docs_drift) — distinto de este, que es por-página.

Véase también

  • [[ia-tech—automatismos—metodo—cf-pages-deploy]]
  • [[decision—20260707—normalizar-sources-related-mcp]]
  • [[ia-tech—biblioteca—incidente-503-1102-julio]]

Referenciado desde

Inicio
Yo