vetcoders vc-guard — egzekutor bramek (nie sędzia)
vc-guard to strażnik, brat vc-trust. Trust obserwuje i osądza po fakcie
na Living Tree. Guard egzekwuje przy bramce.
| Rola | Skill | Kiedy | Zmienia kod? | Blokuje dispatch? | Pisze settlement? |
|---|---|---|---|---|---|
| Sędzia | vc-trust |
po fakcie | nigdy | nigdy | tak (tylko przez jawne note) |
| Egzekutor | vc-guard |
w locie | nigdy | tak (przy trust block) |
nigdy |
| Kształt wiadomości | commit-msg hook |
przy commicie | nigdy | tylko commit | nigdy |
Nie mieszaj tych ról. Guard nie powtarza falsyfikacji. Trust nie odmawia startu.
Kanoniczna bramka strukturalna
Zanim worker skilla vc-guard zinwentaryzuje bramki albo zaraportuje decyzję
egzekucyjną, uruchom lub skonsumuj procedurę vc-init dla przypisanego
repozytorium. Ustal branch, HEAD, stan dirty, właściciela runtime'u i ścieżkę
trust journala. Samo guard check to wąska decyzja na podstawie journala; nie
zastępuje orientacji w repozytorium.
Używaj Loctree:loctree jako domyślnej warstwy strukturalnej, żeby wyprodukować
lub odświeżyć Code-Derived Application Map faktycznej linii egzekucji:
entrypointy hooków, wywołujący enforce_continuation, czytelnicy journala,
wąskie gardła dispatchu i możliwe obejścia. Użyj slice, find i follow, żeby
udowodnić te ścieżki, oraz impact, zanim orzekniesz o pokryciu bramek. Guard
pozostaje niemutujący: ta mapa wspiera prawdziwą inwentaryzację i evidence pod
odmowę, nigdy objazd w stronę implementacji.
Wywołanie
vibecrafted guard <agent> --prompt 'Audit gate inventory and remedium paths'
python -m vibecrafted_core.guard inventory
python -m vibecrafted_core.guard check # HEAD
python -m vibecrafted_core.guard check --sha <sha>
launch_workflow woła enforce_continuation, chyba że VIBECRAFTED_GUARD=0.
Doktryna (twarda)
- Fail-closed — gdy dla docelowego commita zapisano trust
block, kontynuacja jest odmówiona. Brak journala ⇒ brak blokady ⇒ przepuść (sędzią jest trust; brak osądu nie jest blokadą). - Remedium obowiązkowe — każda odmowa wypisuje czytelną dla człowieka ścieżkę naprawy (który journal, które claimy, jak ponownie zbadać i ponownie zanotować).
- Bezpieczne bez interakcji — żadnych promptów na TTY; wyłącznie kody wyjścia.
- Zakaz wymyślania settlementu — litery f/x/n pisze wyłącznie
vc-trust noteprzez istniejące API settlementu (pass→f,pass-with-gaps→n,block→x). Guard tylko czyta werdykty z journala. - Zakaz forkowania AUTONOMY.md — operator buttons (push/merge/deploy) zostają w charterze autonomii; guard ich nie redefiniuje.
- Agent fairness — commit-msg egzekwuje kształt Authored-By; trust falsyfikuje prawdę o fairness; guard może odmówić, gdy trust zablokował linię za naruszenie fairness albo kompletności.
Inwentarz bramek (nazwane, nie reimplementowane)
| Bramka | Faza | Tryb |
|---|---|---|
commit-msg |
commit | twarda — format + trailery + zakaz vendor footerów |
prepare-commit-msg |
commit | pomocnicza — wypełnia trailery |
pre-commit |
commit | twarda — rodzina ruff/prettier/semgrep |
pre-push |
push | twarda — bramki przy pushu |
loctree-first |
agent | polityka — mapa przed grzebaniem |
classifier-hard-stops |
dispatch | polityka — guziki z AUTONOMY |
commit-msg-diff-advisory |
commit | zalążek doradczy — claim vs paczka staged |
trust-block-dispatch |
dispatch | twarda — ścieżka dowodowa tego skilla |
Luki pokrycia (uczciwie): rozsiewanie hooków na całą flotę, podniesienie bramki diffowej do twardej, dryf PATH/instalacji, polityka per-branch wykraczająca poza domyślny HEAD.
Relacja do agent fairness i kompletności f/x/n
- Living Tree dopuszcza równoległe commity; twierdzenia o fairness i tak muszą się bronić.
- commit-msg czyni wiadomość legalną maszynowo.
- vc-trust falsyfikuje, czy legalna wiadomość jest prawdziwa (fairness + kompletność + twierdzenia o runtimie) i pisze settlement.
- vc-guard powstrzymuje flotę przed kontynuowaniem na linii, którą trust zablokował.
Twarda granica
Guard może pisać wyłącznie:
- własny raport/transcript, gdy działa jako worker skilla;
- tekst remedium na stderr przy odmowie.
Guard nigdy nie edytuje kodu, nie amenduje ani nie rewertuje, nie pushuje, nie merguje i nie przepisuje trust journali. Nigdy nie awansuje brakującej notatki trustu na pass.
Kontrakt raportu
- snapshot inwentarza + luki pokrycia;
- decyzja egzekucyjna dla HEAD (przepuszczone/odmówione) ze ścieżką journala;
- jawne przypomnienie, że litery settlementu pochodzą wyłącznie z notatek trustu;
- luki resztkowe.
𝚅𝚒𝚋𝚎𝚌𝚛𝚊𝚏𝚝𝚎𝚍. with AI Agents by Vetcoders (c)2024-2026 LibraxisAI