robisie 0.1.2 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,22 @@
1
1
  # Historia zmian klienta / Client changelog
2
2
 
3
+ ## 0.1.4 (2026-11-04)
4
+
5
+ Wydanie poprawek dokumentacji. / Documentation patch release.
6
+
7
+ - Przewodniki PL/EN i README paczki opisują jednorazową zgodę agenta na nazwany przebieg (konto, klucz, init, pierwsza karta), oddzieloną od końcowego odbioru. / PL/EN guides and the package README describe the agent's one-time consent for a named run (account, key, init, first card), kept separate from final acceptance.
8
+ - Przewodniki wyjaśniają konfigurację ról: trzy role instalatora (`ceo`, `builder`, `quality`) z jednym dostawcą oraz ich odrębność od rejestru wykonania `roleRegistry`. / Guides explain role setup: three installer roles (`ceo`, `builder`, `quality`) with one provider and their separation from the `roleRegistry` execution registry.
9
+ - Ponowna instalacja: odmowa utworzenia istniejącego `package.json` podaje następny krok; aktualizacja przed pierwszym init (`npm i robisie@latest`, bez klucza) jest oddzielona od chronionej aktualizacji po init; polecenia kopii i przywracania przeniesiono z tabel do bloków bez zmiany ścieżek i kolejności. / Reinstallation: refusing to create an existing `package.json` names the next step; the pre-init update (`npm i robisie@latest`, keyless) is separated from the guarded post-init update; backup and restore commands moved from tables to code blocks without changing paths or order.
10
+ - Testy dokumentacji: nowy `docs-014` oraz dostosowane istniejące testy przewodników. / Documentation tests: new `docs-014` and adjusted existing guide tests.
11
+
12
+ ## 0.1.3 (2026-11-04)
13
+
14
+ Wydanie poprawek dokumentacji i pomocy CLI. / Documentation and CLI help patch release.
15
+
16
+ - Przewodniki pierwszej instalacji PL/EN po zimnym teście E4 wyjaśniają wybór klucza worker, ponowną instalację z zachowaniem manifestu oraz wczytanie klucza przed przywróceniem tgz. / Following the E4 cold test, PL/EN first-install guides clarify worker key selection, reinstallation preserving the manifest and key loading before tgz restore.
17
+ - Pomoc `doctor --engine-config` opisuje kontrolę offline struktury konfiguracji i przypisań ról wykonania, jej ograniczenia oraz ścieżki do lokalnych przewodników. / Help for `doctor --engine-config` describes offline checks of configuration structure and execution role assignments, their limits and paths to local guides.
18
+ - Testy dokumentacji wykonują polecenia instalacji, aktualizacji i przywracania, sprawdzając błędne pliki klucza, ochronę manifestów i brak ujawnienia klucza; test pomocy CLI sprawdza opis walidacji offline. / Documentation tests execute install, update and restore commands, checking invalid key files, manifest preservation and absence of key disclosure; a CLI help test checks the offline validation description.
19
+
3
20
  ## 0.1.2 (2026-11-03)
4
21
 
5
22
  Wydanie poprawek klienta i dokumentacji. / Client and documentation patch release.
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # robisie
2
2
 
3
- Przewodniki: [PL — konto → odbiór → odinstalowanie](docs/README.md) · [EN — account → acceptance → uninstall](docs/README.en.md). Przygotuj Node.js 20+, npm, program jednego dostawcy AI oraz pusty katalog; nie potrzebujesz strony ani własnego pliku `package.json` — utworzy go poniższy krok Node.js przed instalacją. Zacznij od konta i projektu w panelu. Projekt w panelu i katalog na dysku to osobne rzeczy; CEO wymaga dokładnie jednego projektu z discovery.
3
+ Przewodniki: [PL — konto → odbiór → odinstalowanie](docs/README.md) · [EN — account → acceptance → uninstall](docs/README.en.md). Przygotuj Node.js 20+, npm, program jednego dostawcy AI oraz pusty katalog; nie potrzebujesz strony ani własnego pliku `package.json` — utworzy go poniższy krok Node.js przed instalacją. Zacznij od konta i projektu w panelu. Projekt w panelu i katalog na dysku to osobne rzeczy; CEO wymaga dokładnie jednego projektu z `list_projects`.
4
4
 
5
- Konto i klucz są potrzebne do init i pracy ról. Osobno `npx robisie doctor --engine-config ./robisie.config.json` sprawdza offline tylko strukturę: nie potwierdza UUID projektu, repo, modeli ani uruchomienia dostawców. Lokalne przewodniki są w `node_modules/robisie/docs/`.
5
+ Konto i klucz są potrzebne do init i pracy ról. Osobne wejście to walidacja offline, gdy CLI jest dostępne: nie sprawdza instalacji, nie uruchamia dostawców i nie wymaga podawania UUID projektu. Osobno `npx robisie doctor --engine-config ./robisie.config.json` sprawdza offline tylko strukturę: nie potwierdza UUID projektu, repo, modeli ani uruchomienia dostawców. Lokalne przewodniki są w `node_modules/robisie/docs/`.
6
6
 
7
7
  ## Przed init — konto i pierwszy projekt
8
8
 
@@ -14,45 +14,103 @@ Jeśli trasa przekierowała na /dashboard bez Planera, znajdź „Zacznij od pie
14
14
 
15
15
  ## Init — połącz agenta
16
16
 
17
- Człowiek generuje klucz worker z etykietą w https://robisie.app/dashboard/connect i podaje go poza rozmową do ukrytego pytania init, nigdy do czatu, argumentu polecenia ani historii powłoki. W zsh/bash usuń stary ENV, a po udanym init wczytaj zapisany klucz do bieżącej powłoki bez wyświetlania go — init nie ustawia jej środowiska. Dla nowej instalacji z Claude wejdź do wybranego pustego katalogu (zastąp przykładową ścieżkę poniżej). Poniższy krok Node.js tworzy lokalny `package.json` niezależnie od nazwy katalogu, także ze spacjami i polskimi znakami. Manifest ustala katalog instalacji także pod przodkiem z `node_modules`. Jeśli ścieżka `package.json` już istnieje (również jako link), krok odmawia zapisu; niczego nie nadpisuje. Błąd wejścia do katalogu lub utworzenia manifestu zatrzymuje dalszy blok:
17
+ <!-- agent-consent:start -->
18
+ ### Instrukcja dla agenta — jedna zgoda na przebieg
19
+
20
+ Na początku poproś raz o zgodę na nazwany przebieg i jego granice: własne konto, wygenerowanie klucza, bezpieczny lokalny zapis klucza, init oraz pierwszą uzgodnioną kartę (cel, katalog, zakres zapisu i kryteria wyniku). Przykład pierwszej karty poniżej obejmuje tylko `wynik.txt`; wybierz ją z właścicielem przed prośbą o zgodę.
21
+
22
+ Jeśli właściciel już udzielił zgody na ten przebieg, nie pytaj ponownie przy tych krokach; kontynuuj w ustalonych granicach. Brak zgody, null, pusta lub niejasna odpowiedź albo zmiana zakresu wymagają pytania przed zależnym krokiem; wykonuj dalej niezależne dozwolone czynności. Odmowę uszanuj: nie wykonuj odmówionych kroków. Zgoda nie omija chronionych potwierdzeń człowieka ani dostawcy; po takim potwierdzeniu kontynuuj. Klucz pozostaje poza rozmową, kartą, argumentami i historią poleceń; gdy bezpieczny zapis lub przekazanie nie jest dostępne, człowiek używa ukrytego pytania init. Cudza otwarta sesja nie daje dostępu do jej konta. Po pracy nadal obowiązują niezależna recenzja oraz osobny końcowy odbiór wyniku przez właściciela.
23
+ <!-- agent-consent:end -->
24
+
25
+ Trzy role instalatora używają jednego dostawcy: CEO (`ceo`), Builder (`builder`), Quality Officer (`quality`). Mieszana mapa nie uruchamia ról między dostawcami, a doctor zwraca kod 1. Dla Claude użyj pełnego przypisania `npx robisie init --agent claude --role ceo=claude --role builder=claude --role quality=claude` zamiast linii init poniżej. Dla Codex/OpenCode zastąp każde `claude` przez `codex`/`opencode`; samo `--agent` nie kasuje wcześniejszej mapy.
26
+
27
+ Ustawienia instalatora `ceo`/`builder`/`quality` (CEO/Builder/Quality Officer) są odrębne od rejestru wykonania `roleRegistry`: `worker-client`, `lead-client`, `reviewer-client`, `tester-client`. Nazwy projektu `coordinator`/`owner`/`planner`/`advisor` to jeszcze inne ustawienie. Nie ma automatycznej konwersji między nimi; rejestr nie włącza mieszanego wykonywania ról instalatora.
28
+
29
+ Jawnie wybierz `worker` w Connect; kolejne klucze mają domyślnie `observer`, który tylko czyta. Człowiek generuje klucz worker z etykietą w https://robisie.app/dashboard/connect i podaje go poza rozmową do ukrytego pytania init, nigdy do czatu, argumentu polecenia ani historii powłoki. W zsh/bash usuń stary ENV, a po udanym init wczytaj zapisany klucz do bieżącej powłoki bez wyświetlania go — init nie ustawia jej środowiska. Dla nowej instalacji z Claude wejdź do wybranego pustego katalogu (zastąp przykładową ścieżkę poniżej). Poniższy krok Node.js tworzy lokalny `package.json` niezależnie od nazwy katalogu, także ze spacjami i polskimi znakami. Manifest ustala katalog instalacji także pod przodkiem z `node_modules`. Jeśli ścieżka `package.json` już istnieje (również jako link), krok odmawia zapisu; niczego nie nadpisuje. Błąd wejścia do katalogu lub utworzenia manifestu zatrzymuje dalszy blok:
18
30
 
19
31
  ```sh
20
32
  cd "/ścieżka/do/pustego katalogu" &&
21
33
  node -e 'try {
22
34
  require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
23
35
  } catch (error) {
24
- console.error(error.message);
36
+ console.error("Nie można utworzyć package.json: ścieżka już istnieje albo jest niedostępna. Następny krok: zachowaj ją i przejdź do instrukcji istniejącego projektu/reinstalacji poniżej; link/katalog lub błąd dostępu wyjaśnij lokalnie przed ponowieniem.");
25
37
  process.exit(1);
26
38
  }' &&
27
39
  {
40
+ set +x
28
41
  npm i robisie &&
29
42
  unset ROBISIE_KEY &&
30
43
  npx robisie init --agent claude &&
31
- [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
32
- ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key")" &&
33
- export ROBISIE_KEY &&
44
+ {
45
+ if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
46
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
47
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
48
+ ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
49
+ [ -n "$ROBISIE_KEY" ]; then
50
+ export ROBISIE_KEY
51
+ else
52
+ printf '%s\n' 'Nie można wczytać niepustego, zwykłego, czytelnego pliku klucza robisie.' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub unieważnieniu klucza wróć do Connect i init z ukrytym pytaniem. Nie wklejaj klucza do rozmowy.' >&2
53
+ false
54
+ fi
55
+ } &&
34
56
  npx robisie doctor
35
57
  }
36
58
  ```
37
59
 
38
60
  Łańcuch `&&` zatrzymuje blok po pierwszym błędzie; osobne przypisanie przed `export` zachowuje błąd odczytu klucza. Po naprawieniu przyczyny ponów nieudany krok i wszystkie następne w tym samym katalogu. Jeśli manifest już powstał, nie twórz go ponownie ani go nie usuwaj. Nie włączaj xtrace ani nie drukuj sekretu.
39
61
 
40
- W istniejącym projekcie zachowaj manifest i użyj instrukcji aktualizacji.
62
+ Dla istniejącego projektu bez `package.json` wykonaj powyższy blok nowej instalacji w katalogu tego projektu: tworzy tylko prywatny manifest i zachowuje pozostałe pliki. Jeśli zwykły manifest już istnieje albo reinstalujesz z zachowanym poprawnym kluczem, użyj poniższego bloku w wybranym katalogu projektu. Wczytuje zapisany klucz przed npm/init/doctor, nie nadpisuje zwykłego manifestu podczas przygotowania i tworzy go przez `wx` tylko przy braku. Samo npm może następnie dopisać zależność robisie oraz zmienić lockfile. Link manifestu (także wiszący) lub katalog odrzuca z wyjaśnieniem. Po uninstall zachowaj pozostawiony `package.json`. Gdy nie ma poprawnego klucza, wróć do Connect i ukrytego pytania init: przy istniejącym zwykłym manifeście wykonaj blok nowej instalacji od `set +x` do doctor, bez kroku `cd`/tworzenia manifestu. Nie usuwaj manifestu, żeby ponowić instalację.
63
+
64
+ <!-- reinstall:start -->
65
+ ```sh
66
+ set +x
67
+ {
68
+ if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
69
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
70
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
71
+ ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
72
+ [ -n "$ROBISIE_KEY" ]; then
73
+ export ROBISIE_KEY
74
+ else
75
+ printf '%s\n' 'Nie można wczytać niepustego, zwykłego, czytelnego pliku klucza robisie.' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub unieważnieniu klucza wróć do Connect i init z ukrytym pytaniem. Nie wklejaj klucza do rozmowy.' >&2
76
+ false
77
+ fi
78
+ } &&
79
+ node -e 'try {
80
+ const fs = require("node:fs");
81
+ let existing;
82
+ try { existing = fs.lstatSync("package.json"); }
83
+ catch (error) { if (error.code !== "ENOENT") throw error; }
84
+ if (existing) {
85
+ if (!existing.isFile()) throw new Error("package.json: wymagany zwykły plik; link i katalog odrzucone");
86
+ } else fs.writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
87
+ } catch (error) {
88
+ console.error(error.message);
89
+ console.error("Następny krok: sprawdź lokalnie package.json; zachowaj plik i wyjaśnij ścieżkę przed ponowieniem.");
90
+ process.exit(1);
91
+ }' &&
92
+ npm i robisie &&
93
+ npx robisie init &&
94
+ npx robisie doctor
95
+ ```
96
+ <!-- reinstall:end -->
41
97
 
42
98
  Dla Codex lub OpenCode zastąp `claude` przez `codex` lub `opencode`. Sam `--agent` nie usuwa wcześniejszej mapy ról: przy wcześniejszej konfiguracji użyj pełnej mapy z sekcji init w przewodniku. Nowy terminal wymaga obsługi profilu zsh/bash bez `--no-shell`; w innych sesjach wczytaj środowisko zgodnie z przewodnikiem. Agenta uruchom z katalogu instalacji; szczegóły startu ról, pomocników i diagnozy są w przewodnikach PL/EN powyżej.
43
99
 
44
100
  ## Po init — sprawdź gotowość CEO
45
101
 
46
- Po Connect, init i wczytaniu klucza według bloku powyżej uruchom `npx robisie doctor`. Discovery to odczyt aktywnych projektów przez `list_projects`. Nie wymaga wpisywania UUID. Sam `init` z exit 0 ani „połączono” nie wystarczają do potwierdzenia gotowości CEO.
102
+ Po Connect, init i wczytaniu klucza według bloku powyżej uruchom `npx robisie doctor`. Odczyt projektów to odczyt aktywnych projektów przez `list_projects`. Nie wymaga wpisywania UUID. Sam `init` z exit 0 ani „połączono” nie wystarczają do potwierdzenia gotowości CEO.
47
103
 
48
104
  - **0 projektów, exit 1:** `CEO wymaga dokładnie 1 projektu (projektów: 0).` Następny krok: `Sprawdź gotowość projektu na https://robisie.app/dashboard/plugins/planer.` Wróć do przygotowania projektu opisanego przed init.
49
- - **Więcej niż 1 projekt, exit 1** (np. `CEO wymaga dokładnie 1 projektu (projektów: 2).`): `Uporządkuj widoczność projektów w discovery do 1; sam wybór projektu w panelu nie zmienia discovery.` Człowiek sam decyduje, który projekt zachować aktywny; przy pozostałych na liście wybiera „Archiwizuj”. „Archiwum” → „Przywróć” cofa archiwizację. Nie usuwaj projektów. Kliknięcie projektu nie zawęża discovery.
105
+ - **Więcej niż 1 projekt, exit 1** (np. `CEO wymaga dokładnie 1 projektu (projektów: 2).`): Uporządkuj widoczność projektów w `list_projects` do 1; sam wybór projektu w panelu nie zmienia wyniku `list_projects`. Człowiek sam decyduje, który projekt zachować aktywny; przy pozostałych na liście wybiera „Archiwizuj”. „Archiwum” → „Przywróć” cofa archiwizację. Nie usuwaj projektów. Kliknięcie projektu nie zawęża wyniku `list_projects`.
50
106
  - **1 projekt:** oczekuj dokładnie `✓ Połączenie działa: klucz otwiera tablicę (projektów: 1).` oraz końcowego `Wszystko działa. Uruchom swojego agenta i poproś o rolę robisie CEO.` i exit 0.
51
107
 
52
108
  Po zmianie ponów `npx robisie doctor`. Rozwiąż też inne błędy doctor: sam licznik 1 nie wystarcza bez końcowego komunikatu sukcesu i exit 0.
53
109
 
54
110
  Po sukcesie człowiek potwierdza nazwę i cel projektu oraz katalog instalacji, bez klucza i UUID. Przejdź do startu CEO poniżej; to nie jest odbiór karty.
55
111
 
112
+ Przykład pierwszej karty: w katalogu instalacji utwórz tylko `wynik.txt` z treścią „robisie działa” i końcowym znakiem nowej linii; sprawdź dokładną treść odczytem, bez zależności i publikacji.
113
+
56
114
  ## Start CEO
57
115
 
58
116
  Człowiek uruchamia CEO w katalogu instalacji.
@@ -67,23 +125,46 @@ W Claude Code CEO uruchamia niezależnego Quality Officera przez `Agent(quality-
67
125
 
68
126
  OpenCode: karta pozostaje w `in_review` niezależnie od dostępności narzędzia Agent; brak wspieranego przejścia do `delivered`. Pełny odbiór wymaga opisanej w przewodnikach drogi Claude Code.
69
127
 
70
- Codex: przejście do delivered wymaga niezależnej recenzji oraz zweryfikowanego potwierdzenia (verified receipt). Jeśli w sesji CEO brakuje narzędzia Agent, karta pozostaje w `in_review` i wymaga naprawy integracji przez CEO/CR.
128
+ Codex: przejście do delivered wymaga niezależnej recenzji oraz zweryfikowanego potwierdzenia (verified receipt). Jeśli w sesji CEO brakuje narzędzia Agent, karta pozostaje w `in_review` i wymaga naprawy integracji przez osobę odpowiedzialną za integrację CEO.
71
129
 
72
130
  Wszystkie trzy role muszą używać jednego dostawcy; mieszana mapa daje kod 1 doctor. Paczka nie uruchamia usług w tle ani nie zapewnia konta lub dostępu do AI.
73
131
 
132
+ ### Aktualizacja przed pierwszym init
133
+
134
+ W przygotowanym katalogu instalacji, przed pierwszym init, aktualizacja samej paczki npm nie wymaga klucza ani `manifest.json` instalatora. Zachowaj istniejący manifest projektu; w pustym katalogu utwórz najpierw lokalny `package.json` samym krokiem Node powyżej. Następnie wykonaj jedną linię; do wybranego przepisu init przejdź, gdy konto i klucz będą gotowe.
135
+
136
+ <!-- before-init-update:start -->
137
+ ```sh
138
+ npm i robisie@latest
139
+ ```
140
+ <!-- before-init-update:end -->
141
+
142
+ ### Aktualizacja po init
143
+
74
144
  Aktualizuj w katalogu instalacji po prywatnej kopii opisanej w przewodnikach. Init nie czyta automatycznie pliku key: pierwszeństwo ma ROBISIE_KEY, potem ukryte pytanie, potem jawny `--key-stdin`. Wczytaj stary klucz przed init/doctor z tym samym XDG_CONFIG_HOME, bez xtrace i bez wydruku:
75
145
 
146
+ <!-- update:start -->
76
147
  ```sh
77
148
  set +x
78
- [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
79
- ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key")" &&
80
- export ROBISIE_KEY &&
149
+ {
150
+ if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
151
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
152
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
153
+ ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
154
+ [ -n "$ROBISIE_KEY" ]; then
155
+ export ROBISIE_KEY
156
+ else
157
+ printf '%s\n' 'Nie można wczytać niepustego, zwykłego, czytelnego pliku klucza robisie.' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub unieważnieniu klucza wróć do Connect i init z ukrytym pytaniem. Nie wklejaj klucza do rozmowy.' >&2
158
+ false
159
+ fi
160
+ } &&
81
161
  npm i robisie@latest &&
82
162
  npx robisie init &&
83
163
  npx robisie doctor
84
164
  ```
165
+ <!-- update:end -->
85
166
 
86
- Doctor sprawdza MAJOR kontraktu. Przy niezgodności wybierz zgodne wydanie. Poprzedni zgodny tgz przygotuj przez `npm pack robisie@<wersja>`; komenda powrotu `npm i --no-save "$backup/robisie-$previous_version.tgz"` wymaga jawnie wybranej wersji, prywatnej kopii konfiguracji i porównania późniejszych własnych zmian według przewodników. Opcja `--no-save` zachowuje przywrócone `package.json` i `package-lock.json`, bez zapisywania zależności `file:` od ścieżki prywatnej kopii. Kolejność powrotu: konfiguracja i tgz → ENV starego klucza → init → doctor. To nie jest automatyczny rollback.
167
+ Doctor sprawdza MAJOR kontraktu. Przy niezgodności wybierz zgodne wydanie. Poprzedni zgodny tgz przygotuj przez `npm pack robisie@<wersja>`; komenda powrotu `npm i --no-save "$backup/robisie-$previous_version.tgz"` wymaga jawnie wybranej wersji, prywatnej kopii konfiguracji i porównania późniejszych własnych zmian według przewodników. Opcja `--no-save` zachowuje przywrócone `package.json` i `package-lock.json`, bez zapisywania zależności `file:` od ścieżki prywatnej kopii. Kolejność powrotu: konfiguracja i OBA manifesty projektu (`package.json`, `package-lock.json`) → ENV starego klucza → tgz → init → doctor. To nie jest automatyczny rollback.
87
168
 
88
169
  Pomocniki uruchamiaj z cwd instalacji przez `npx robisie mcp <nazwa>`; init nadal generuje transport dla wersji paczki. npx może pobrać brakującą wersję z sieci. Bez instalacji zacznij od konta → init; przy istniejącej instalacji rozwiąż błędy ewidencji i odczytu klucza przed błędami sieci. Odinstalowanie może zmienić package.json, package-lock.json i node_modules; cache npm może zostać, a npx może pobrać paczkę ponownie. Bez masowego kasowania. Windows/WSL są niezweryfikowane.
89
170
 
@@ -121,3 +202,5 @@ Uruchom `npx robisie doctor --engine-config ./robisie.config.json` (także `--en
121
202
  Kod 0 oznacza poprawną strukturę konfiguracji i dokładnie cztery kompletne przypisania wykonania; raport pokazuje rolę → imię / dostawcę / model / wysiłek. Kod 1 wskazuje plik, błędne pole (jeśli dotyczy) i następny krok. Ten tryb działa offline, bez klucza, uruchamiania dostawców, wykonywania komend silnika ani zapisu plików. Raport jawnie stwierdza: „sprawdzono konfigurację; nie sprawdzono uruchomienia dostawców”. Zwykły `doctor` zachowuje dotychczasową diagnozę instalacji.
122
203
 
123
204
  Modele i wysiłki to przykładowe, dosłowne etykiety, bez gwarancji dostępności lub obsługi przez CLI. `grok-cli`/`none` opisują obecny review-job; nie dowodzą sterowania modelem ani wysiłkiem Groka. Imię jest metadanymi rejestru; Execution v1 zachowuje `{contractVersion:1,provider,model,effort}`. Walidacja nie jest odbiorem wykonania karty, dostawców ani całego procesu pracy.
205
+
206
+ Backupy po uninstall mogą nadal zawierać klucz; zachowaj ich prywatność i własną retencję, bez automatycznego kasowania. Jeśli README w rejestrze jest puste, użyj lokalnych przewodników w `node_modules/robisie/docs/`; naprawa rejestru i publikacja to osobny zakres wydania.
package/dist/cli.js CHANGED
@@ -17,8 +17,12 @@ const HELP = `robisie ${PACKAGE_VERSION} — łączy Twojego agenta z tablicą r
17
17
  pomocnik ról (serwer MCP stdio) — uruchamia go agent, nie Ty
18
18
 
19
19
  Opcje doctor:
20
- --engine-config <path> lokalnie i offline sprawdza K2 i rejestr wykonania czterech ról K7
20
+ --engine-config <path> offline sprawdza strukturę konfiguracji projektu i przypisania czterech ról wykonania
21
21
  --engine-config=<path> ta sama składnia; nie sprawdza uruchomienia dostawców
22
+ Przykład: npx robisie doctor --engine-config ./robisie.config.json
23
+ Bez klucza i kontroli instalacji; nie sprawdza UUID projektu, repo, dostępności modeli ani wykonania komend.
24
+ Role wykonania w tym pliku są osobne od mapy ceo/builder/quality ustawianej przez init.
25
+ Przewodniki i przykłady: node_modules/robisie/docs/README.md oraz README.en.md w tym samym katalogu.
22
26
 
23
27
  Opcje init:
24
28
  --agent <${AGENT_IDS.join("|")}> wybrany dostawca (można powtórzyć albo podać po przecinku); razem z dostawcami mapy, bez --agent również wykryci
@@ -1,6 +1,6 @@
1
1
  /** Package identity and the server contract it speaks. */
2
2
  export declare const PACKAGE_NAME = "robisie";
3
- export declare const PACKAGE_VERSION = "0.1.2";
3
+ export declare const PACKAGE_VERSION = "0.1.4";
4
4
  /**
5
5
  * MAJOR of the agent-API contract this package understands.
6
6
  * PARITY: src/lib/mcp/contract-version.ts (AGENT_API_CONTRACT_VERSION) on the server.
package/dist/constants.js CHANGED
@@ -1,6 +1,6 @@
1
1
  /** Package identity and the server contract it speaks. */
2
2
  export const PACKAGE_NAME = "robisie";
3
- export const PACKAGE_VERSION = "0.1.2"; // x-release-please-version
3
+ export const PACKAGE_VERSION = "0.1.4"; // x-release-please-version
4
4
  /**
5
5
  * MAJOR of the agent-API contract this package understands.
6
6
  * PARITY: src/lib/mcp/contract-version.ts (AGENT_API_CONTRACT_VERSION) on the server.
@@ -5,12 +5,17 @@ async function robisieReviewGuard() {
5
5
  "tool.execute.before": async (input, output) => {
6
6
  if (typeof input !== "object" || input === null || !("tool" in input))
7
7
  return;
8
- if (input.tool !== "robisie_create_task" && input.tool !== "robisie_update_task")
8
+ if (input.tool !== "robisie_create_task" && input.tool !== "robisie_update_task" && input.tool !== "robisie_create_tasks")
9
9
  return;
10
10
  if (typeof output !== "object" || output === null || !("args" in output))
11
11
  return;
12
12
  const args = output.args;
13
- if (typeof args === "object" && args !== null && "status" in args && args.status === "delivered") {
13
+ if (typeof args !== "object" || args === null)
14
+ return;
15
+ const delivered = input.tool === "robisie_create_tasks"
16
+ ? "tasks" in args && Array.isArray(args.tasks) && args.tasks.some((task) => typeof task === "object" && task !== null && "status" in task && (task.status === "delivered" || task.status === "wdrożone"))
17
+ : "status" in args && (args.status === "delivered" || args.status === "wdrożone");
18
+ if (delivered) {
14
19
  throw new Error("Brak wspieranego protokołu recenzji w OpenCode. Ta próba nie zmieniła karty.");
15
20
  }
16
21
  },
package/dist/roles.d.ts CHANGED
@@ -17,7 +17,7 @@ export interface Role {
17
17
  export declare function rolesDir(): string;
18
18
  export declare function parseRole(file: Role["file"], text: string): Role;
19
19
  export declare function loadRoles(dir?: string): Role[];
20
- export declare const MANAGED_LINE = "<!-- robisie:managed 0.1.2 \u2014 plik zarz\u0105dzany przez `npx robisie`; `npx robisie uninstall` go usunie -->";
20
+ export declare const MANAGED_LINE = "<!-- robisie:managed 0.1.4 \u2014 plik zarz\u0105dzany przez `npx robisie`; `npx robisie uninstall` go usunie -->";
21
21
  export type AgentFlavor = "claude" | "codex" | "opencode";
22
22
  /** How the operator starts the Builder for one card in its own session (the card id is not a secret). */
23
23
  export declare function builderStartCommand(flavor: AgentFlavor, codexRolePath?: string): string;
@@ -0,0 +1,10 @@
1
+ export type SeedPackage = Readonly<{
2
+ scope: string;
3
+ spec: string;
4
+ brief: string;
5
+ }>;
6
+ export declare function embeddedDetails(card: Readonly<{
7
+ details: unknown;
8
+ }>, seedPackage: SeedPackage): Record<string, unknown>;
9
+ export declare function readbackMismatches(details: unknown, seedPackage: SeedPackage): string[];
10
+ export declare function parseSeedPackage(raw: string): SeedPackage;
@@ -0,0 +1,62 @@
1
+ import { createHash } from "node:crypto";
2
+ function isRecord(value) {
3
+ return value !== null && typeof value === "object" && !Array.isArray(value);
4
+ }
5
+ function stripFence(text) {
6
+ let value = text.trim();
7
+ const opening = value.match(/^```(?:json)?\s*/i);
8
+ if (opening !== null)
9
+ value = value.slice(opening[0].length);
10
+ value = value.replace(/\s*```\s*$/, "");
11
+ return value.trim();
12
+ }
13
+ function errorText(error) {
14
+ return error instanceof Error ? error.message : String(error);
15
+ }
16
+ function sha256(content) {
17
+ return createHash("sha256").update(content, "utf8").digest("hex");
18
+ }
19
+ export function embeddedDetails(card, seedPackage) {
20
+ const original = isRecord(card.details) ? card.details : {};
21
+ return {
22
+ ...(Object.hasOwn(original, "card_class") ? {} : { card_class: "executable" }),
23
+ seed_scope: seedPackage.scope,
24
+ seed_scope_sha256: sha256(seedPackage.scope),
25
+ seed_spec: seedPackage.spec,
26
+ seed_spec_sha256: sha256(seedPackage.spec),
27
+ seed_brief: seedPackage.brief,
28
+ seed_brief_sha256: sha256(seedPackage.brief),
29
+ };
30
+ }
31
+ export function readbackMismatches(details, seedPackage) {
32
+ if (!isRecord(details))
33
+ return ["details nie są obiektem"];
34
+ const mismatches = [];
35
+ for (const field of ["scope", "spec", "brief"]) {
36
+ const contentKey = `seed_${field}`;
37
+ const hashKey = `${contentKey}_sha256`;
38
+ const content = details[contentKey];
39
+ const expected = seedPackage[field];
40
+ if (content !== expected || typeof content !== "string" || details[hashKey] !== sha256(content)) {
41
+ mismatches.push(contentKey);
42
+ }
43
+ }
44
+ return mismatches;
45
+ }
46
+ export function parseSeedPackage(raw) {
47
+ let parsed;
48
+ try {
49
+ parsed = JSON.parse(stripFence(raw));
50
+ }
51
+ catch (error) {
52
+ throw new Error(`odpowiedź modelu nie jest JSON: ${errorText(error)}`);
53
+ }
54
+ if (!isRecord(parsed))
55
+ throw new Error("odpowiedź modelu nie jest obiektem");
56
+ for (const field of ["scope", "spec", "brief"]) {
57
+ if (typeof parsed[field] !== "string" || parsed[field].trim().length === 0) {
58
+ throw new Error(`brak niepustego pola ${field}`);
59
+ }
60
+ }
61
+ return { scope: parsed.scope, spec: parsed.spec, brief: parsed.brief };
62
+ }
@@ -0,0 +1 @@
1
+ export declare function taskMktempEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
@@ -0,0 +1,40 @@
1
+ import { lstatSync, mkdtempSync, writeFileSync } from "node:fs";
2
+ import path from "node:path";
3
+ import { workerEnv } from "./worker-env.js";
4
+ // Only omitted templates need rewriting; explicit paths and unknown options belong to mktemp.
5
+ const wrapper = `#!/bin/bash
6
+ if [[ -z "$TMPDIR" || "$TMPDIR" != /* || ! -d "$TMPDIR" || ! -w "$TMPDIR" ]]; then
7
+ echo 'ACTIONABLE: brak zapisywalnego TMPDIR zadania' >&2
8
+ exit 1
9
+ fi
10
+ original=("$@")
11
+ flags=()
12
+ prefix=tmp
13
+ while getopts ':dqut:p:' flag; do
14
+ case "$flag" in
15
+ d|q|u) flags+=("-$flag") ;;
16
+ t) prefix="$OPTARG" ;;
17
+ *) exec /usr/bin/mktemp "\${original[@]}" ;;
18
+ esac
19
+ done
20
+ shift "$((OPTIND - 1))"
21
+ if (( $# > 0 )); then exec /usr/bin/mktemp "\${original[@]}"; fi
22
+ if [[ "$prefix" == */* ]]; then
23
+ echo 'mktemp: prefix must not contain a slash' >&2
24
+ exit 1
25
+ fi
26
+ exec /usr/bin/mktemp "\${flags[@]}" "$TMPDIR/$prefix.XXXXXXXX"
27
+ `;
28
+ export function taskMktempEnv(env) {
29
+ try {
30
+ const tmp = env.TMPDIR;
31
+ if (!tmp || !path.isAbsolute(tmp) || !lstatSync(tmp).isDirectory())
32
+ throw new Error("brak katalogu zadania");
33
+ const bin = mkdtempSync(path.join(tmp, "mktemp-bin-"));
34
+ writeFileSync(path.join(bin, "mktemp"), wrapper, { mode: 0o700, flag: "wx" });
35
+ return { ...workerEnv(env, tmp), PATH: `${bin}${path.delimiter}${env.PATH ?? ""}` };
36
+ }
37
+ catch (error) {
38
+ throw new Error(`ACTIONABLE: podkładka mktemp TMPDIR zadania: ${error instanceof Error ? error.message : String(error)}`);
39
+ }
40
+ }