AITM uchovává poměrně dost stavu lokálně, aby mohl spolehlivě fungovat a pamatovat si, co se o vašich projektech naučil. Toto je srozumitelná mapa toho, co se ukládá a proč na tom pro vás záleží.
Jaká data AITM ukládá
Mapa dat
| Co to je | Kde to žije | Proč na tom záleží |
|---|---|---|
| Databáze projektu | Vyhrazený databázový soubor pro každý spravovaný projekt | Obsahuje kontrakty a historii tasků daného projektu — udržováno odděleně pro každý projekt, takže se data jednoho projektu nikdy nemísí s daty jiného |
| Globální databáze | Jedna sdílená databáze pro AITM samotné | Obsahuje celoaplikační nastavení, hinty, registr proměnných a další konfiguraci napříč projekty |
| Logy běhu tasků | Složky logů pro jednotlivé projekty | Podrobný, řádek po řádku záznam toho, co se dělo během běhu tasku — užitečné pro ladění tasku, který se choval neočekávaně |
| Složky dat tasků | Složky tasků pro jednotlivé projekty, jedna podsložka na číslo tasku | Obsahuje soubory výsledku daného tasku, metadata a případné pořízené screenshoty — toto pohání pohled Čtení výsledků a archiv |
| Worktrees | Dočasné Git checkouty, jeden na běžící task | Izolovaná pracovní kopie, kterou AI agenti tasku skutečně upravují; vytvoří se při spuštění tasku a automaticky se odstraní po sloučení — viz Pipeline |
| Dokumenty znalostního grafu | Automaticky generované dokumentační soubory | Čitelné exporty kontraktů a znalostí o závislostech popsaných v kapitole Sdílení znalostí; po každém sloučení se automaticky přegenerují |
Proč na lokálním, trvalém stavu záleží
Nic z toho není náhodné účetnictví — je to mechanismus stojící za vším ostatním popsaným v této příručce:
- Databáze projektu je to, co umožňuje kontraktům, historii tasků a vyhledávání precedentů přežít mezi sezeními a mezi tasky, místo aby se resetovaly pokaždé, když aplikaci zavřete.
- Složky dat tasků jsou to, co dělá z Archivu skutečně užitečnou auditní stopu, ne jen seznam názvů — každý výsledek, screenshot a pole metadat, které tam vidíte, se čte přímo z těchto složek.
- Worktrees jsou mechanickým základem záruky izolace popsané v kapitole Pipeline — protože každý task dostane skutečně oddělený checkout na disku, rozdělaná práce nikdy nemůže omylem uniknout do vaší hlavní větve.
- Dokumenty znalostního grafu jsou to, co promění "AI si náhodou něco zapamatovala" na "projekt má trvalý, prozkoumatelný záznam o svém vlastním chování" — viz Sdílení znalostí.
Jak jsou zálohy databází chráněny před nekontrolovaným růstem a tichou ztrátou dat
Zálohy databází samy o sobě potřebují ochranu — jinak by mohly buď zaplnit disk, nebo tiše zmizet v okamžiku, kdy je nejvíc potřebujete. AITM proto zálohy udržuje ve vrstvené politice uchovávání a hlídá jejich velikost:
- Vrstvené uchovávání — místo jednoho pevného počtu dní, po kterých se všechny starší zálohy databáze smažou najednou (což by při jednom vynechaném denním běhu mohlo smazat úplně všechny zálohy databáze), AITM postupně zálohy prořezává: udržuje si několik posledních denních záloh, pár starších záloh rozprostřených s odstupem několika dní a jednu ještě starší týdenní zálohu. Výsledkem je malý, ale rozprostřený počet bodů, ke kterým se lze vrátit, aniž by disk neomezeně rostl.
- Hlídání neobvyklé velikosti — před každým prořezáváním AITM porovná velikost dnešní zálohy databáze s velikostí té včerejší. Výrazný propad velikosti (možná ztráta dat) i výrazný neočekávaný nárůst si vyžádá e-mailové upozornění s uvedením předchozí a nové velikosti a procentuální změny, takže o anomálii víte dřív, než by se stará dobrá záloha přepsala nebo smazala.
- Prořezávání přírůstkových (delta) záloh s ověřením — přírůstkové obnovovací zálohy starší než 3 dny se průběžně mažou, ale vždy až poté, co je nejnovější zachovávaná záloha v dané řadě ověřena jako neporušená. Pokud ověření nejnovější zálohy selže, mazání se pro danou databázi zastaví a nic staršího se nesmaže — jedna poškozená nejnovější záloha tak nemůže strhnout s sebou i starší, funkční zálohy.
Tipy
- Kód vašeho projektu se nikdy neupravuje mimo worktree — vaše běžná pracovní kopie zůstává nedotčená, dokud task běží.
- Z vašeho počítače se nikam neposílá nic kromě volání vašemu nakonfigurovanému AI providerovi.
- Tato lokální, trvalá znalost je to, co umožňuje AITM zlepšovat se ve vašem projektu v čase, místo aby u každého tasku začínal od nuly.