majordomus recover

Vrátit úložiště záznamů tohoto checkoutu do stavu, který popisuje kontrakt: zavřít epizody, které nikdo neukončil, sloučit duplicitní záznamy jedné epizody do jednoho a roztřídit zbloudilé soubory, které se v úložištích hromadí. Opakovaná, idempotentní údržba — na rozdíl od migrate, což je jednorázový přesun z rozvržení před .ai, který odmítne běžet dvakrát.

Subjekty: status (výchozí, pouze čtení), episodes, records, orphans, all.

Čte: .ai/local/state/sessions-open/, .ai/local/state/ledger.jsonl, úložiště uzavřených záznamů a úložiště checkpointů a předávek. Zapisuje: uzavřený záznam pro každou obnovenou epizodu pod .ai/repo/sessions/, sloučený záznam tam, kde existovaly duplicity, řádek knihy session.recovered pro každou akci a odstraňuje otevřené záznamy a zatoulané dočasné soubory, na kterých zasáhl.

Behaviour:

• --check vypíše plán a důkazy za ním a nic nezapíše. Totéž měření řídí skutečný běh, takže plán je akce.
• Zbloudilý soubor se posuzuje podle stáří dřív než podle obsahu: dočasný soubor publikace starý vteřiny patří session close, které právě běží, a .mj-stage.XXXXXX staré minuty scripts/derive, které právě běží. Obojí se hlásí jako live a ani jedno se nedotkne; soubor, jehož stáří nelze přečíst, se přeskočí a započítá.
• Zastaralý staging adresář se hlásí a nikdy neodstraňuje. Tento příkaz nemaže žádný strom adresářů — SECURITY.md uvádí „žádné rekurzivní mazání“ — takže .mj-stage.XXXXXX za prahem se jmenuje, počítá se jako přeskočený a nechá se člověku k odstranění.
• Epizoda je uvízlá, když je její poslední známka života — pozdější z jejího vlastního started_at a nejnovějšího řádku knihy, který označila — starší než session.stranded_after. --older-than <duration> pro jeden běh přepíše politiku.
• Mezi živou epizodou a úklidem stojí dvě pojistky a ani jedna není zálohou té druhé. Epizoda, na kterou se tento proces překládá, je vyloučena dříve, než se spustí jakýkoli predikát; a kandidát, jehož důkaz nelze přečíst jako časové razítko, se přeskočí a započítá, nikdy se nepovažuje za nejstarší v množině (project.destructive-sweeps-fail-closed). Epizoda patřící jinému worktree se ohlásí a tady se nikdy nezavře.
• Obnovený záznam nese to, co dokazují otevřený záznam a vlastní řádky knihy epizody. commits a changed_files jsou explicitní prázdný seznam a head a working_tree chybí: popisují uzavření, které se nikdy nestalo, a pracovní strom v okamžiku obnovy patří tomu, kdo právě pracuje. outcome je interrupted, čím také bylo.
• Duplicitní záznamy se sloučí do nejstaršího podle created_at s sjednocením seznamů, které ostatní dokládají, a názvy nahrazených souborů se zapíší do těla přeživšího. Záznamy, které se neshodují v identitě nebo časech epizody, se ohlásí a nic se neslučuje.
• Nic se nemaže jen proto, že to nebylo rozpoznáno. Dočasný soubor publikace po prahu, který drží jedinou kopii záznamu, se publikuje; ten, jehož epizoda je už publikována, nebo prázdný, se odstraní; ten, který drží obsah, jejž tato verze neumí klasifikovat, zůstane přesně tam, kde je, a započítá se. Adresář, který někdo vložil do úložiště kontrolních bodů, se pojmenuje, změří a ponechá.
• Idempotentní. Dvojí spuštění nad jedním předmětem provede jeho akce jednou a spuštění po pádu uprostřed běhu provede ty, které se nestaly: záznam se zapíše dřív, než se odstraní otevřený soubor, takže přerušení mezi nimi nic nestojí.

$ majordomus recover episodes --check
episodes — open episodes in .ai/local/state/sessions-open
  s-20260910194205-72ea  key=187c9e1e-…  last seen 2026-09-10T19:42:05Z (ledger, 13h ago)
    stranded: 13h ago, over the 12h threshold; close with outcome interrupted
  s-20260911063532-b41b  key=c93d195f-…  last seen 2026-09-11T08:31:02Z (ledger, 0m ago)
    live: this process is inside it; never a candidate

check: 1 action(s) would be taken and nothing was written (run: majordomus recover all)