Zdůvodnění
Tento repozitář má jeden slovník pro vzdálenost mezi zaznamenanou hlavou a checkoutem před vámi — exact, advanced, diverged, different_context — a uplatňuje ho téměř všude. Záznam úlohy je označen dřív, než builder kontextu vytiskne pod ním řádek. Rozlišená předávka je označena a stejně tak checkpoint. Odvození označí hlavu, z níž vyšlo. Uzavřený záznam relace je označen session show a o tom jednom je celý případ. Vzor je záměrný: zaznamenaná hlava je tvrzení o historii a tvrzení o historii má hodnotu přesně takovou, jak se shoduje s historií v pracovním stromě.
Pracovní kontext otevřené epizody byl výjimkou. Nese head: a branch: ve svém front matter jako každý z jeho sousedů a nic je neporovnávalo. To je horší, než to zní, kvůli tomu, čím tento dokument je. Není to artefakt, který pracovník vyhledá, když ho chce — je to briefing, jednou vyřešený startovacím hookem poskytovatele a doručený do kontextu pracovníka v okamžiku otevření epizody, a pak už nikdy zmíněný. Každou jinou zaznamenanou hlavu v tomto repozitáři čte někdo, kdo se pro čtení rozhodl. Tuto čte někdo, kdo se nerozhodl, nemůže ji přečíst znovu a nemá jak zjistit, že se repozitář posunul bez něj.
Relace tak mohla pracovat celé odpoledne z popisu stromu, který už neexistoval, a context, session context i doctor by každý mlčely, protože každý z nich kontroloval vztah ve všech směrech kromě tohoto. Změřený případ: briefing zmrazený na jednom headu, zatímco trunk ho dvakrát předběhl, a nikde nic, co by to říkalo.
Selháním není zastarání. Zastarání je normální život briefingu — stává se advanced ve chvíli, kdy jeho vlastní relace vytvoří commit, a different_context ve chvíli, kdy worker přejde na větev, kterou měl stavět. Selháním je jednosměrná kontrola: vztah, který tento repozitář ověřuje u každého sourozeneckého artefaktu a nechal bez vlastníka u jediného artefaktu, který nikdo nezvolil číst.
Požadované chování
Porovnání existuje a je pojmenováno. Povrch, který workerovi předá pracovní kontext otevřené epizody, uvádí vzdálenost mezi headem, který ten dokument zaznamenal, a headem checkoutu, pěti slovy výše. unknown je slovo pro dokument, který nenese head ani větev; briefing, který nelze porovnat, se nesmí nikdy číst jako aktuální.
Drift se hlásí, nikdy neodmítá. Žádná kontrola nezpůsobí selhání epizody kvůli briefingu, který postoupil nebo se přesunul na jinou větev. Doktrína, která by to dělala, by zastavila každý commit v tomto repozitáři a byla by špatně i věcně: briefing je pozadu, protože práce šla dobře.
Vzdálenost je číslo tam, kde číslo něco znamená. advanced nese počet commitů získaných od zmrazení, protože podle „váš briefing je o čtyři commity starý“ lze jednat a podle „váš briefing je zastaralý“ ne. diverged a different_context nejsou vzdálenosti a žádnou nenesou.
Dokument se nepřepisuje, aby report vyšel čerstvý. Pracovní kontext je zmrazený důkaz toho, co bylo pracovníkovi řečeno, a úložiště, které by přepisovalo vlastní historii pod promptem, jenž ji spotřeboval, by mělo menší cenu než to, které přizná své stáří. Chybělo stáří, ne mutace. K opětovnému rozřešení slouží majordomus context a jeho výstup briefing nahrazuje, aniž by jej přepisoval.
Žádné druhé slovo pro zastaralé. Slovník pochází z mj_git_label a nic tu nevymýšlí paralelní. Čtenář, který se naučil, co advanced znamená pro předávku, se naučil, co znamená pro briefing.
Chování při selhání
Povrchy hlásí; nic neodmítá. Jediný stav, který selže, je unknown podle doktríny majordomus.session-lifecycle, protože dokument, který tento nástroj zapsal, vždy nese obě pole a jejich absence znamená, že se rozbil producent, ne že se repozitář posunul.
Ověření
test/cases/127_briefing_freshness.sh otevře epizodu, ověří, že všechny tři povrchy říkají exact a žádný nevaruje, posune trunk o dva commity a ověří, že každý hlásí advanced s počtem, přepne na jinou větev a ověří different_context s varováním od sestavovače kontextu a bez selhání doktríny, odstraní z dokumentu hlavu a ověří, že doktrína selže na unknown, a odsune dokument stranou, aby ověřil, že absence se stále hlásí jako absence. Případ nesou negativní aserce: stráž, která by varovala před každým briefingem, by splnila pozitivní a přitom by pracovníkovi nic neřekla.