5.6 KiB
herdr-composer — instalowalna paczka (projekt + plan)
Zatwierdzone przez użytkownika 2026-11-19. Wykonawca: Ovis Fast. Review: Ovis Opus.
Cel
Prywatny mod (repo http://git.mkali.pl/Factor/herdrMario.git) instalowany jedną komendą — przez agenta (wzór herdr.dev: „Read ~/.config/herdr-app/AGENTS.md, then add this layout: …”) albo install.cmd. Nazwa herdr-composer (zamiast ovis-composer). Bez publikacji na GitHub/herdr.dev.
Decyzje
- Format paczki wg
~/.config/herdr-app/AGENTS.md(„Layouts and mods other people made”): folderherdr/herdr-composer/=layouts/herdr-composer.json,mods/herdr-composer/*,keys.json,RECIPE.md,preview.png. - Instalacja przez kopię (nie junction) → Herdr sam przeładowuje mod; aktualizacja = ponowne
install.cmd. - Zmiana nazwy bez utraty danych: odczyt
herdr-composer.*, a gdy brak —ovis-composer.*(i zapis pod nową nazwą).
Zadanie A (Ovis Fast) — restrukturyzacja + zmiana nazwy + migracja
git mv mod/ovis-composer herdr/herdr-composer/mods/herdr-composer;git mv layouts/ovis-composer.json herdr/herdr-composer/layouts/herdr-composer.json(w layouciecontent.mod→herdr-composer). Usuń pustemod/,layouts/.- W kodzie modu wszystkie identyfikatory
ovis-composer→herdr-composer:CONTEXT/key_context, nazwy akcjiherdr-composer.*(bind_keys + on_action), kluczestorage.KEYS(herdr-composer.history,.favorites,.usage,.userMin,.draft:<a>,.queue:<a>), folder obrazówdata/herdr-composer/paste/,id()elementów, komentarze/teksty..gitignore:herdr/herdr-composer/mods/herdr-composer/gpui-kit.d.ts. - Migracja w
storage.js(czyste, testowane): każda funkcjaload*czyta nowy klucz; gdynull/undefined— czyta kluczovis-composer.*(ta sama końcówka) i, jeśli coś znalazła, zapisuje to pod nowym kluczem. Stare klucze zostają nietknięte.cleanupPastesprząta oba foldery (data/ovis-composer/pastei nowy). herdr/herdr-composer/keys.json:{"global": {"ctrl-shift-space": "herdr-composer.focus"}}.- Testy: importy z
../herdr/herdr-composer/mods/herdr-composer/<m>.js; nowe testy migracji (nowy klucz wygrywa; fallback ze starego + zapis pod nowym; brak obu → domyślne; śmieci w starym kluczu → ignorowane jak dotąd). grep -ri "ovis-composer"wherdr/itests/→ tylko w kodzie migracji i w RECIPE (zdanie o pochodzeniu).
Zadanie B (Ovis Fast) — instalator
install.cmd w korzeniu repo (wywołuje powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0scripts\install.ps1" %*) i przepisany scripts/install.ps1 (PowerShell 5):
install(domyślnie): jeśli repo jest klonem git i nie ma lokalnych zmian →git pull --ff-only(błąd = ostrzeżenie, kontynuacja). Kopiujeherdr/herdr-composer/mods/herdr-composer→%USERPROFILE%\.config\herdr-app\mods\herdr-composer(mirror:robocopy /MIR, kod wyjścia < 8 = OK; pomijagpui-kit.d.ts,jsconfig.json) i layout →layouts\herdr-composer.json. Scaleniekeys.jsonpaczki dokeys.jsonużytkownika (kopiakeys.json.bak-herdr-composerraz; nie nadpisuje istniejącego klawisza innego niż nasz — ostrzeżenie). Na końcuherdr-app check …\mods\herdr-composeriherdr-app do layout.switch '{"name":"herdr-composer"}'; brakherdr-appw PATH → ostrzeżenie, nie wyjątek.- Sprzątanie poprzedniej wersji (
ovis-composer): jeślimods\ovis-composerjest junction →cmd /c rmdir(tylko link); jeśli zwykły katalog → przenieś domods\ovis-composer.bak-<data>.layouts\ovis-composer.json→ przenieś do.bak-<data>. Wkeys.jsonusuń wpis wskazujący naovis-composer.focus. Nigdy nie usuwaj plików repo. -Uninstall: usuwamods\herdr-composer,layouts\herdr-composer.json, nasz klawisz zkeys.json, przełącza namain.- README: sekcja „Instalacja” — (1) przez agenta:
Read ~/.config/herdr-app/AGENTS.md, then add this layout: clone http://git.mkali.pl/Factor/herdrMario.git and use the folder herdr/herdr-composer; (2) jedna komenda:git clone http://git.mkali.pl/Factor/herdrMario.git "%USERPROFILE%\herdrMario" && "%USERPROFILE%\herdrMario\install.cmd"; aktualizacja: ponownieinstall.cmd; odinstalowanie:install.cmd -Uninstall. - Usuń
-Reloadi junction z dokumentacji (nieaktualne).
Zadanie C (Ovis Fast) — RECIPE.md + preview.png
herdr/herdr-composer/RECIPE.md dokładnie wg struktury z AGENTS.md (Name + akapit + ; What you see; How it behaves; Built from; Watch out). W Built from/Watch out jawnie: uruchamia powershell (exec: schowek, wybór pliku, rozmiary plików — ścieżki tylko jako Base64), hc (send, put, get, interrupt, keys), czyta pliki spoza swojego folderu (pliki użytkownika wskazane jako załączniki, git ls-files w folderze agenta); „+” i Ctrl+V obrazu tylko Windows; layout jest klonem main (wersja z cloned_from); UX inspirowany Ovis (devswha/ovis). preview.png: zrzut herdr-app shot okna z composerem (po instalacji, Zadanie D).
Zadanie D (Ovis Opus) — instalacja na tej maszynie i weryfikacja
install.cmd na tym komputerze → herdr-app status bez błędów, layout herdr-composer, historia/ulubione/drafty widoczne (migracja), Ctrl+Shift+Space, panel, test w GUI. preview.png ze zrzutu.
Kryteria akceptacji
npm testzielone;herdr-app checkmodu OK.- Po
install.cmdHerdr pokazuje composer w layoucieherdr-composer, historia sprzed zmiany nazwy jest widoczna. - Zmiana w repo + ponowne
install.cmd→ Herdr przeładowuje mod bez dodatkowych kroków. install.cmd -Uninstallzostawia~/.config/herdr-appbez śladówherdr-composer(poza kopiami.bak).