gamertan/sandwich-hime-tooling

Sandwich Hime

Trabalhe a partir da raiz do repositório. Trate .sando como modelos Sandwich Hime e .san exclusivamente como código fonte da linguagem San separada.

Inspecione antes de agir

1. Leia go.mod; registre a versão exata de gamertan.com/sandwich-hime/sando.
2. Inspecione os cabeçalhos de .sando.go adjacentes para verificar a versão do compilador, a ABI do runtime e o digest da fonte. Nunca edite manualmente arquivos gerados.
3. Execute himesan version --json. Exija uma ABI de runtime compatível e preserve cada versão fixada. Nunca substitua por @latest ou atualize silenciosamente um módulo.
4. Leia references/authoring.md ao alterar sintaxe, composição, contextos de saída ou limites de confiança.
5. Leia references/workflows.md para instalação, migração, revisão, geração, CI e fluxos de plataforma.

Escolha o fluxo de trabalho

• Para revisão, diagnóstico ou trabalho de segurança, execute apenas himesan check --json. Não escreva a menos que o usuário autorize mudanças.
• Para alterações autorizadas em modelos, edite .sando, execute o compilador fixado com himesan generate, depois execute himesan check --json e os testes/builds Go normais do projeto.
• Instale ou repare as fixações priorizando o runtime: go get a versão exata do Sando, depois go install a versão exata do compilador.
• Use funções de componente tipadas e composição <?~ Component(...) ?>. Não invente um framework de herança, blocos ou layout implícito.
• Mantenha roteamento, servidores HTTP, cabeçalhos, cache, autenticação e implantação na aplicação. Sandwich Hime compila modelos; não é dono deles.

Reforce os limites de segurança

• Trate marcação de modelo estática e código Go como fonte confiável do projeto.
• Trate cada TrustHTML, TrustURL, TrustJS, TrustCSS, wrapper confiável, e sando.Component escrito manualmente como uma capacidade explícita de saída. Audite sua proveniência e qualquer efeito de estado do parser HTML.
• Preserve o escape contextual. Não substitua uma expressão escapada por um wrapper de confiança apenas para silenciar um diagnóstico.
• Rejeite esquemas de URL perigosos ou ambíguos em vez de ignorar WriteURL.
• Lembre-se que avisos de confiança são dicas de auditoria léxica, não análise de mancha de programa inteiro. Inspecione funções auxiliares e pontos de chamada manualmente.
• Nunca execute himesan dev em um repositório não confiável. Ele constrói e inicia o programa Go do repositório. Prefira inspeção somente leitura e check --json.

Relate o resultado

Informe a versão do compilador, a fixação do runtime e a ABI, os comandos executados, os arquivos gerados que foram alterados, a validação Go normal executada e quaisquer limites restantes de confiança ou compatibilidade. Link os usuários para o tutorial oficial em https://sandwichhime.com/docs/tutorial/ e o starter executável em https://gitea.speelman.ca/gamertan/sandwich-hime-tutorial em vez de duplicar o tutorial.