gamertan/sandwich-hime-tooling

Sandwich Hime

Trabaja desde la raíz del repositorio. Trata .sando como plantillas de Sandwich Hime y .san exclusivamente como código fuente del lenguaje San independiente.

Inspeccionar antes de actuar

1. Lee go.mod; registra la versión exacta de gamertan.com/sandwich-hime/sando.
2. Inspecciona las cabeceras de los archivos .sando.go adyacentes para conocer la versión del compilador, la ABI del runtime y el resumen de origen. Nunca edites manualmente los archivos generados.
3. Ejecuta himesan version --json. Exige una ABI de runtime compatible y conserva cada versión fijada. Nunca sustituyas por @latest ni actualices un módulo en silencio.
4. Lee references/authoring.md cuando modifiques la sintaxis, la composición, los contextos de salida o los límites de confianza.
5. Lee references/workflows.md para los flujos de instalación, migración, solo revisión, generación, CI y plataforma.

Elegir el flujo de trabajo

• Para revisión, diagnóstico o trabajo de seguridad, ejecuta solo himesan check --json. No escribas a menos que el usuario autorice los cambios.
• Para cambios autorizados en plantillas, edita los archivos .sando, ejecuta el compilador fijado con himesan generate, luego ejecuta himesan check --json y las pruebas/compilaciones normales de Go del proyecto.
• Instala o repara las fijaciones primero en el runtime: go get la versión exacta de Sando, luego go install la versión exacta del compilador.
• Usa funciones de componente tipadas y composición <?~ Component(...) ?>. No inventes un marco de herencia, bloques o diseño implícito.
• Mantén el enrutamiento, los servidores HTTP, las cabeceras, el almacenamiento en caché, la autenticación y el despliegue en la aplicación. Sandwich Hime compila plantillas; no es dueño de ellas.

Imponer límites de seguridad

• Trata el marcado estático de las plantillas y el código Go como código fuente del proyecto de confianza.
• Trata cada TrustHTML, TrustURL, TrustJS, TrustCSS, envoltorio de confianza y sando.Component escrito a mano como una capacidad explícita de salida. Audita su procedencia y cualquier efecto en el estado del analizador HTML.
• Conserva el escape contextual. No reemplaces una expresión escapada con un envoltorio de confianza solo para silenciar un diagnóstico.
• Rechaza esquemas de URL peligrosos o ambiguos en lugar de omitir WriteURL.
• Recuerda que las advertencias de confianza son pistas léxicas de auditoría, no un análisis de flujo de datos de todo el programa. Inspecciona las funciones auxiliares y los sitios de llamada manualmente.
• Nunca ejecutes himesan dev en un repositorio no confiable. Compila e inicia el programa Go del repositorio. Prefiere la inspección de solo lectura y check --json.

Informar el resultado

Indica la versión del compilador, la fijación del runtime y la ABI, los comandos ejecutados, los archivos generados modificados, la validación normal de Go realizada y cualquier límite de confianza o compatibilidad restante. Enlaza a los usuarios al tutorial oficial en https://sandwichhime.com/docs/tutorial/ y al iniciador ejecutable en https://gitea.speelman.ca/gamertan/sandwich-hime-tutorial en lugar de duplicar el tutorial.