Nastavení stroje a repozitáře

Přihlašovací údaje

Jedny na nasazení, získané schválením v prohlížeči, ne vlepeným tajemstvím.

vitrinka auth login
vitrinka auth status    # nasazení, ke kterým má stroj údaje
vitrinka auth token     # vypíše uložený token pro dosazení v shellu
vitrinka auth logout

Navázání repozitáře

Naváže tento repozitář na workspace v nasazení, aby příkazy spuštěné z něj věděly, kam patří.

vitrinka config bind acme --project myapp

Operátorská persona

Výchozí jméno, pod kterým se z tohoto stroje připisují zápisy na nástěnku. Napište ho jednou a každý další zápis je připsaný vám.

vitrinka config operator            # zobrazí
vitrinka config operator "Olivia"   # nastaví

Zapojení repozitáře

setup zapojí repozitář: zapíše checkout do evidence tohoto stroje, vyznačí projekt a origin v commitovaném vitrinka.config.json, navrhne ke kontrole politiku indexu pro @ a zapojí agentní hooky. Pošle také ikonu repozitáře — první ze známých souborů v jeho kořeni (public/apple-touch-icon.png … favicon.ico, nebo Expo expo.icon) — jako ikonu projektu; ikona, kterou někdo vybral ve vitrince, zůstane, pokud nepoužijete --force-icon. project index index cest pro doplňování později obnoví; project index configure upraví politiku, project index status ji ukáže.

vitrinka setup
vitrinka project index

setup sám zjistí, kam repozitář patří — do projektu, pod kterým ho tento stroj už eviduje, jinak do projektu workspace, který jeho origin deklaruje, jinak do nového projektu pojmenovaného podle repozitáře — a ukáže to při kontrole; --project to přebije. Projekt, který se táhne přes víc repozitářů — API, aplikace, infra — je jeden projekt s několika repozitáři, nikdy několik projektů. link zařadí repozitář pod existující projekt (bez argumentu na terminálu vybíráte z projektů workspace), unlink ho zase vyjme:

vitrinka project link acme        # přidá origin tohoto repa do projektu acme
vitrinka project link             # výběr z projektů workspace
vitrinka project unlink

Každý zapojený checkout se zapíše do evidence tohoto počítače (~/.config/vitrinka/config.json). vitrinka doctor evidenci porovná s diskem a workspacem a pojmenuje, co se rozjelo — zmizelá cesta, origin, který projekt nedeklaruje, zastaralý setup. vitrinka doctor --fix nejdřív vypíše celý plán, změny na počítači a na serveru provede po jednom potvrzení a u každého repozitáře se zeptá, jak mají commitované soubory přistát: jako worktree větev s PR (chráněný main), commit na aktuální větvi, nebo jen zápis souborů.

Soubory repozitáře

Navázaný repozitář nese JEDEN commitovaný soubor, vitrinka.config.json v kořeni: project, origins (origin → workspace), run (stacky, které spouští párování a pipeline session), runners (kam testovací runnery zapisují výsledky — vitrinka setup --runners), capture (hidpi: webové snímky ve 2×, zapnuté, pokud není nastaveno jinak — vitrinka config hidpi) a politiku index. Commitněte ho; žádné tajemství v něm není. Všechno lokální pro stroj — záznamy, artefakty, logy, stav párování a usertestu — žije v .vitrinka/, který se ignoruje sám, takže do .gitignore nikdy nepřidávejte řádek pro vitrinku. Starší .vitrinka/project.json další zápis složí do kořenového souboru; vitrinka doctor ho pojmenuje.

Hooky a trailery commitů

Práce je záznam, takže setup zapojí obě místa, kde se už děje. V agentním harnessu hooky SessionStart, SessionEnd, Stop a PreToolUse navážou session na její úkol, připomenou todo, která se spustila, hlídají předání práce a ohlásí todo vázané na cestu, když se jeho soubor upravuje — hooky session. V gitu spouští hook prepare-commit-msg v každém repozitáři vitrinka commit-msg: na větvi (nebo ve worktree) vt-<id> připojí trailer Vitrinka-Task: vt-<id>, podle kterého GitHub App připojí commit i pull request k úkolu. Merge, squash ani fixup zprávy nikdy nemění a vždy skončí kódem 0 — commit kvůli vitrince nikdy neselže. Cizí shellový hook se zřetězí, nikdy nepřepíše; setup uninstall odstraní přesně svůj blok.

vitrinka project commits                 # ukáže konvenci tohoto projektu
vitrinka project commits --subject on    # i prefix předmětu s id úkolu
vitrinka workspace commit-prefix colon   # styl prefixu pro celý workspace

Trailer se zapisuje vždy. Prefix předmětu se zapíná pro každý projekt zvlášť a má styl workspace: bracket ([vt-401], výchozí), bare (vt-401) nebo colon (vt-401:); styl nastavuje admin workspace.

Úklid repozitáře

project tidy naplánuje přesuny starých kořenů záznamu a zatoulaných snímků do .vitrinka/. Dokud nedáte --yes, jen plánuje.

vitrinka project tidy          # plán
vitrinka project tidy --yes    # provede