Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

Záznamy relací jsou sdílené objekty s uzavřenou množinou polí

Záznamy relací jsou sdílené objekty s uzavřenou množinou polí

majordomus://rule/majordomus.session-records@1aktivní sessionrecordsschema

Zdůvodnění

Repozitář, který neumí říct, co se v něm stalo, závisí na tom, kdo u toho byl, a ten člověk odejde. Záznam musí být artefakt a artefakt, který nikdo nemůže dotazovat, je archiv, ne paměť — proto je záznam druh, objevovaný a promítaný jako každý jiný, a ne datovaný soubor v adresáři, který si někdo pamatuje otevřít.

Dvěma věcmi se sdílený záznam nesmí stát. Nesmí se stát přepisem: shrnutí konverzace je neověřitelné, špatně stárne a činí model, který je napsal, autoritou nad tím, co se stalo. A nesmí se stát popisem stroje: absolutní cesta platí o jednom disku, nikde jinde nic neznamená a ve veřejném repozitáři je odhalením bez účelu. Kontrakt činí obě odmítnutí mechanickými, a ne pamatovanými.

Požadované chování

majordomus session close zapisuje záznam; nic jiného žádný nezapisuje a nic ho poté neupravuje. Zapíše se do sekce, kterou manifest jmenuje — .ai/repo/sessions/ — a každé pole jeho front matter je odvozeno: časy z hodin, heady a commity z gitu a seznamy odkazů z událostí ledgeru pro danou epizodu. Jediná autorská část je tělo a to shrnuje práci, ne konverzaci.

Front matter splňuje session-record: schema: session/v1, druh, identita, dva časy a výsledek jsou přítomny, neznámý klíč je chyba, žádná hodnota není absolutní cesta a žádné dva záznamy si nenárokují jednu identitu. Repozitář je pojmenován svým remote a pracovní kopie hashem, takže záznam identifikuje, odkud pochází, aniž by říkal, kde žije.

Objevování je třída zdroje session a tato deklarace je celá registrace: index, zdroj MCP, routy objektů, graf, web a cockpit ji následují.

Chování při selhání

Porušení je nález FAIL v kategorii session, který jmenuje záznam a co je s ním špatně, a příkaz, který jej našel, končí s 10; pod watch je to drift a příkaz končí s 11. Index v Rustu odmítne tentýž záznam při sestavení, s uvedením problematického klíče, takže malformovaný záznam se nemůže dostat do projekce.

Ověření

Rozhoduje o tom mj_validate_session_records, volané z doctor, watch. Behaviorální případ test/cases/63_session_records.sh to dokazuje mutací: záznam s neznámým klíčem, s absolutní cestou, s duplicitní identitou a s neznámým schématem, každý zamítnutý jménem; a jedna uzavřená epizoda, která se dostane do indexu, grafu i výpisu, aniž by se cokoli registrovalo. Rozhodnutí zaznamenává ADR 0014.

Odkud to pochází

kanonický soubor
.ai/repo/rules/vendor/majordomus/rules/session-records.v1.md
identity
majordomus.session-records@1
dostupné také jako
Zdroj MCP majordomus://rule/majordomus.session-records@1 · majordomus entity show rule/majordomus-session-records-1 · GET /api/v1/entity?uri=majordomus://rule/majordomus.session-records@1
v Cockpitu
/cockpit/objects/rule/majordomus-session-records-1

Tato stránka je generována z výše uvedeného souboru pomocí scripts/generate-site-data; úprava stránky nic nemění, úprava souboru změní všechna rozhraní. Výše uvedené vztahy jsou hrany docs/generated/graph.json, které spustitelný program zapisuje ze stejného indexu.

Prohledává názvy a popisy všech stránek, které tento web publikuje.