TTT-b/stremio-ai-translator – Git-Workflow

Git- und GitHub-Workflow

Remote: origin = https://github.com/TTT-b/stremio-ai-translator. Standard-Branch: main. Windows PowerShell-Befehle.

Arbeitsbeginn

1. git status -sb und git fetch origin.
2. Wenn der Arbeitsbaum sauber ist: git pull --ff-only. Falls nicht sauber, abbrechen und dem Benutzer mitteilen, was geändert ist.

Während der Arbeit

• Für alles nicht Triviale auf einem Branch arbeiten: git switch -c <kurzer-name>. Kleine sichere Korrekturen dürfen nur dann direkt auf main gehen, wenn der Benutzer dies sagt.
• Kleine, fokussierte Commits. Nachricht: vX.Y.Z: kurze Zusammenfassung für Releases, sonst typ: kurze Zusammenfassung (fix:, feat:, docs:, test:, chore:).
• Dateien einzeln stagegen (git add <datei>), niemals blind git add . oder -A. Zuerst git diff --staged prüfen.
• Niemals .env, settings.json, data/, logs/, node_modules/, dist-electron/, release/, Tokens oder API-Schlüssel committen. Falls ein Secret committet wurde, stoppen und den Benutzer bitten, es zu rotieren.
• Vor jedem Commit npm run check ausführen. Nicht committen, wenn der Check fehlschlägt.

Pushen

• Nur pushen, wenn der Benutzer darum bittet. Normaler Push: git push. Niemals --force auf main. Falls auf einem persönlichen Branch wirklich ein Force-Push nötig sein sollte, --force-with-lease verwenden und vorher fragen.
• Releases: version in package.json erhöhen, ggf. README/TROUBLESHOOTING aktualisieren (wenn sich das Verhalten geändert hat), committen, dann mit git tag vX.Y.Z taggen und git push --follow-tags nur nach Bestätigung des Benutzers ausführen. Jeder Tag muss auf einen eigenen Commit zeigen.

Release-Prüfungen (jedes Release, nicht nur bei Auffälligkeiten)

1. npm run check ist erfolgreich (beinhaltet den Test, dass RELEASE_NOTES für die in package.json angegebene Version sowohl he- als auch en-Notizen enthält).
2. Die Version in package.json ist höher als der aktuellste veröffentlichte Tag (git tag --sort=-v:refname | Select-Object -First 1); der In-App-Updater bietet nur höhere Versionen an.
3. Mit npm run dist bauen und den Benutzer bitten, das Programm zunächst aus release/ zu installieren; auf sein OK warten, bevor veröffentlicht wird.
4. Nach der Veröffentlichung muss gh release view vX.Y.Z den Installer .exe, dessen .blockmap und die latest.yml auflisten. Ohne latest.yml findet die In-App-„Auf Updates prüfen“-Funktion nichts.
5. Den Benutzer bitten, in der vorherigen Version „Auf Updates prüfen“ zu drücken und zu bestätigen, dass die neue Version angeboten wird.

Synchronisation mit Laptop/Telefon

• Der Desktop ist die Arbeitsmaschine. Wenn der Benutzer sagt, GitHub sei aktualisiert: git fetch origin, zeige git log --oneline HEAD..origin/main, dann git pull --ff-only. Wenn kein Fast-Forward möglich ist, zeige die Abweichung und frage vor Merge oder Rebase.

Empfohlene GitHub-Einstellungen (vom Benutzer im Web-UI gesetzt)

Repo-Einstellungen -> Branches: main schützen (Pull-Request erforderlich, Force-Pushes blockieren, Löschen blockieren). Einstellungen -> Codesicherheit: Secret Scanning mit Push-Schutz aktivieren, Dependabot-Alarme und Dependabot-Sicherheitsupdates aktivieren. Einstellungen -> Allgemein: „Automatisch Head-Branches löschen“ aktivieren. Konto: Zwei-Faktor-Authentifizierung einschalten.