Co to znamená
Projekce deklarovaná pomocí mode: region vlastní text mezi <!-- majordomus:begin <policy hash> <content hash> --> a <!-- majordomus:end --> a nic jiného. Vše mimo ty dva řádky patří repozitáři, nikdy se nečte jako vstup a nikdy se nepřepisuje. update vloží vykreslené tělo do oblasti; doctor a watch porovnávají tělo oblasti s hashem obsahu v jejím vlastním markeru, nikdy soubor.
Princip
lib/common.sh nese primitiva: mj_region_extract vrací aktuální tělo oblasti a rozlišuje chybějící začáteční značku od poškozených značek; mj_region_splice přestaví celý soubor kolem nového těla; mj_projection_mode nenastavené mode doplní na file, takže každá existující politika si zachová své chování. lib/update.sh vykreslí šablonu poskytovatele do oblasti a zapíše hash politiky a hash těla oblasti do začáteční značky. Neznámý režim je chyba politiky a končí kódem 10, místo aby se hádalo. lib/doctor.sh a lib/watch.sh čtou režim z politiky a porovnávají tělo oblasti s jeho značkou; kontroly rozpočtu, odkazů a počtů měří oblast a délku hostitelského dokumentu hlásí jen jako informaci, protože hostitele nástroj zkracovat nemá.
Jak to vidět
majordomus update # writes the region into CLAUDE.md
echo "a paragraph of my own" >> CLAUDE.md
majordomus doctor # ok — the edit is outside the region
sed -i '' 's/one active task/two active tasks/' CLAUDE.md
majordomus doctor
# FAIL projection CLAUDE.md — content differs from its own stamp (hand-edited?)Co nepokrývá
Nástroj nevytváří značky za vás v souboru, který nezapsal. Pokud chybí počáteční značka, update připojí oblast na konec souboru; kam v dokumentu oblast patří, je redakční rozhodnutí. Značky, které existují, ale jsou poškozené — začátek bez konce nebo konec před začátkem — se odmítnou, ne opraví.
Proč existuje
Repozitář, který už má ručně psaný CLAUDE.md, si musel vybrat mezi zachováním vlastního kořene správy a převzetím nástroje. mode: region volbu odstraňuje: autorský text zůstává závazný a generovaná dozorová sekce sedí uvnitř něj, označená jako každá jiná projekce.