Outils Sandwich Hime

Sandwich Hime

Travaillez depuis la racine du dépôt. Traitez .sando comme des modèles Sandwich Hime et .san exclusivement comme source pour le langage San séparé.

Inspectez avant d'agir

1. Lisez go.mod ; enregistrez exactement la version de gamertan.com/sandwich-hime/sando.
2. Inspectez les en-têtes des fichiers .sando.go adjacents pour la version du compilateur, l'ABI du runtime, et le digest de la source. Ne modifiez jamais manuellement les fichiers générés.
3. Exécutez himesan version --json. Exigez une ABI de runtime compatible et préservez chaque version épinglée. Ne remplacez jamais par @latest et ne mettez pas à jour silencieusement un module.
4. Lisez references/authoring.md lorsque vous modifiez la syntaxe, la composition, les contextes de sortie ou les limites de confiance.
5. Lisez references/workflows.md pour les workflows d'installation, migration, révision uniquement, génération, CI et plateforme.

Choisissez le workflow

• Pour la révision, le diagnostic ou le travail de sécurité, exécutez uniquement himesan check --json. N'écrivez pas sauf si l'utilisateur autorise des modifications.
• Pour les modifications de templates autorisées, modifiez .sando, exécutez himesan generate du compilateur épinglé, puis exécutez himesan check --json ainsi que les tests/compilations Go normaux du projet.
• Installez ou réparez les épingles runtime en premier : go get la version exacte de Sando, puis go install la version exacte du compilateur.
• Utilisez des fonctions de composants typés et la composition <?~ Component(...) ?>. N'inventez pas de cadre d'héritage, de bloc ou de mise en page implicite.
• Conservez le routage, les serveurs HTTP, les en-têtes, la mise en cache, l'authentification et le déploiement dans l'application. Sandwich Hime compile des templates ; il ne les possède pas.

Appliquez les limites de sécurité

• Traitez le balisage statique des templates et le code Go comme des sources de projet de confiance.
• Traitez chaque TrustHTML, TrustURL, TrustJS, TrustCSS, wrapper de confiance et sando.Component écrit à la main comme une capacité de sortie explicite. Auditez sa provenance et tout effet sur l'état de l'analyseur HTML.
• Préservez l'échappement contextuel. Ne remplacez pas une expression échappée par un wrapper de confiance simplement pour faire taire un diagnostic.
• Rejetez les schémas d'URL dangereux ou ambigus au lieu de contourner WriteURL.
• Rappelez-vous que les avertissements de confiance sont des indices lexicaux d'audit, et non une analyse de pollution complète du programme. Inspectez manuellement les fonctions d'aide et les sites d'appel.
• N'exécutez jamais himesan dev dans un dépôt non fiable. Il compile et démarre le programme Go du dépôt. Préférez l'inspection en lecture seule et check --json.

Rapportez le résultat

Indiquez la version du compilateur, l'épingle et l'ABI du runtime, les commandes exécutées, les fichiers générés modifiés, la validation Go normale effectuée, ainsi que toute limite de confiance ou compatibilité restante. Liez les utilisateurs vers le tutoriel officiel sur https://sandwichhime.com/docs/tutorial/ et le démarrage exécutable sur https://gitea.speelman.ca/gamertan/sandwich-hime-tutorial plutôt que de dupliquer le tutoriel.