gamertan/sandwich-hime-tooling

Sandwich Hime

Arbeiten Sie vom Repository-Stammverzeichnis aus. Behandeln Sie .sando als Sandwich-Hime-Vorlagen und .san ausschließlich als Quellen für die separate San-Sprache.

Prüfen vor dem Handeln

1. Lesen Sie go.mod und notieren Sie die exakte Version von gamertan.com/sandwich-hime/sando.
2. Überprüfen Sie angrenzende .sando.go-Header auf Compiler-Version, Laufzeit-ABI und Source-Digest. Bearbeiten Sie generierte Dateien niemals von Hand.
3. Führen Sie himesan version --json aus. Verlangen Sie eine kompatible Laufzeit-ABI und bewahren Sie jede festgelegte Version. Ersetzen Sie niemals @latest und aktualisieren Sie ein Modul nicht stillschweigend.
4. Lesen Sie references/authoring.md, wenn Sie Syntax, Komposition, Ausgabekontexte oder Vertrauensgrenzen ändern.
5. Lesen Sie references/workflows.md für Installations-, Migrations-, Review-Only-, Generierungs-, CI- und Plattform-Workflows.

Wählen Sie den Workflow

• Für Review, Diagnose oder Sicherheitsarbeit führen Sie nur himesan check --json aus. Schreiben Sie nicht, es sei denn, der Benutzer autorisiert Änderungen.
• Für autorisierte Vorlagenänderungen bearbeiten Sie .sando, führen den festgelegten Compiler mit himesan generate aus, dann himesan check --json sowie die normalen Go-Tests/Builds des Projekts.
• Installieren oder reparieren Sie Pins runtime-first: go get die exakte Sando-Version, dann go install die exakte Compiler-Version.
• Verwenden Sie typisierte Komponentenfunktionen und die <?~ Component(...) ?>-Komposition. Erfinden Sie kein Vererbungs-, Block- oder implizites Layout-Framework.
• Behalten Sie Routing, HTTP-Server, Header, Caching, Authentifizierung und Deployment in der Anwendung. Sandwich Hime kompiliert Vorlagen; es besitzt sie nicht.

Sicherheitsgrenzen durchsetzen

• Behandeln Sie statisches Vorlagen-Markup und Go-Code als vertrauenswürdige Projektquellen.
• Behandeln Sie jedes TrustHTML, TrustURL, TrustJS, TrustCSS, jeden vertrauenswürdigen Wrapper und jede handgeschriebene sando.Component als explizite Ausgabefähigkeit. Prüfen Sie deren Herkunft und jeglichen HTML-Parser-Zustandseffekt.
• Bewahren Sie kontextuelles Escaping. Ersetzen Sie keinen escapeten Ausdruck durch einen Trust-Wrapper, nur um eine Diagnose zu unterdrücken.
• Lehnen Sie gefährliche oder mehrdeutige URL-Schemata ab, anstatt WriteURL zu umgehen.
• Denken Sie daran, dass Trust-Warnungen lexikalische Audit-Hinweise sind, keine ganzheitliche Taint-Analyse. Prüfen Sie Hilfsfunktionen und Aufrufstellen manuell.
• Führen Sie himesan dev niemals in einem nicht vertrauenswürdigen Repository aus. Es baut das Go-Programm des Repositorys und startet es. Bevorzugen Sie schreibgeschützte Inspektion und check --json.

Ergebnis melden

Geben Sie die Compiler-Version, den Laufzeit-Pin und ABI, ausgeführte Befehle, geänderte generierte Dateien, die normalen Go-Validierungsläufe sowie verbleibende Trust- oder Kompatibilitätsgrenzen an. Verlinken Sie Benutzer auf das offizielle Tutorial unter https://sandwichhime.com/docs/tutorial/ und den lauffähigen Starter unter https://gitea.speelman.ca/gamertan/sandwich-hime-tutorial, anstatt das Tutorial zu duplizieren.