Was macht audit-flush?
Manuelles Gegenstück zum Stop-Hook. Gleiche Logik, auf Abruf ausgeführt.
Wann verwenden
- Der Benutzer bittet darum, die bereitgestellten Prüfprotokolleinträge vor dem automatischen Leeren zu überprüfen.
- Der Benutzer möchte Einträge erneut versuchen, die nach einem vorherigen Fehler (Secret-Hit oder Push-Fehler) in das Verzeichnis
$CCAUDIT_PENDING_DIRverschoben wurden. - Auto-Flush ist deaktiviert (
CCAUDIT_MANUAL=1) und Einträge müssen explizit geleert werden. - Der Benutzer benötigt einen schriftlichen Nachweis, dass " diese Leerung zum Zeitpunkt X überprüft und genehmigt hat" – das Ausführen von
/audit-flushhinterlässt eine Spur (Commit-Autor und Zeitstempel), die ein unbeaufsichtigter Stop-Hook nicht kann.
Flags
| Flag | Verhalten |
|---|---|
| (keines) | Gleicher Ablauf wie hooks/auto-flush.sh: scannen, Secret-Prüfung, pushen, Staging löschen. |
--dry-run | Auflisten, was geleert würde, beenden ohne etwas zu ändern. |
--force | Zusätzlich zum Staging den Inhalt von $CCAUDIT_PENDING_DIR einbeziehen; alles erneut versuchen. |
Vorgehen
Befolgen Sie Schritt für Schritt skills/audit-flush/procedure.md. Erfinden Sie keine zusätzlichen Sicherheitsprüfungen – der Hook und dieses Skill müssen verhaltensidentisch bleiben, da Abweichungen undefinierte Zustände verursachen.
Was dieses Skill NICHT tut
- Es ändert keine Prüfprotokolleinträge. Einträge sind Append-Only, sobald sie im Staging geschrieben wurden.
- Es löscht nichts aus dem entfernten Prüfprotokoll-Repository. Wenn ein fehlerhafter Eintrag gepusht wurde, besteht die Korrektur in einem neuen Eintrag, der per Hash auf den fehlerhaften verweist – niemals eine Überschreibung.
- Es konfiguriert das entfernte Repository nicht neu.
CCAUDIT_TRAIL_REPOist aus Sicht dieses Skills schreibgeschützt.