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 +17 -0
- package/README.md +98 -15
- package/dist/cli.js +5 -1
- package/dist/constants.d.ts +1 -1
- package/dist/constants.js +1 -1
- package/dist/opencode-review-guard.js +7 -2
- package/dist/roles.d.ts +1 -1
- package/dist/seed-package.d.ts +10 -0
- package/dist/seed-package.js +62 -0
- package/dist/task-mktemp.d.ts +1 -0
- package/dist/task-mktemp.js +40 -0
- package/docs/README.en.md +203 -66
- package/docs/README.md +203 -66
- package/docs/RELEASE-0.1.0.md +2 -0
- package/package.json +1 -1
package/docs/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# robisie — od konta do odebranej karty (paczka 0.1.
|
|
1
|
+
# robisie — od konta do odebranej karty (paczka 0.1.4)
|
|
2
2
|
|
|
3
3
|
English: [README.en.md](README.en.md).
|
|
4
4
|
|
|
@@ -7,10 +7,12 @@ English: [README.en.md](README.en.md).
|
|
|
7
7
|
<!-- sekcja: dostepnosc -->
|
|
8
8
|
## Dostępność
|
|
9
9
|
|
|
10
|
-
Konto i klucz są potrzebne do init i pracy ról. Osobno `npx robisie doctor --engine-config ./robisie.config.json` sprawdza offline tylko strukturę konfiguracji: nie potwierdza UUID projektu, repo, modeli ani uruchomienia dostawców. Przewodniki z tej paczki znajdziesz lokalnie w `node_modules/robisie/docs/README.md` i `node_modules/robisie/docs/README.en.md`; nie trzeba pobierać ich ze strony.
|
|
10
|
+
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ę konfiguracji: nie potwierdza UUID projektu, repo, modeli ani uruchomienia dostawców. Przewodniki z tej paczki znajdziesz lokalnie w `node_modules/robisie/docs/README.md` i `node_modules/robisie/docs/README.en.md`; nie trzeba pobierać ich ze strony.
|
|
11
11
|
|
|
12
12
|
Zainstaluj robisie z npm w przygotowanym katalogu; w nim uruchamiaj dalsze polecenia i sesje agentów. [Przygotowanie](#wymagania) → [konto](#konto) → [klucz](#klucz) → [instalacja](#instalacja) → [odbiór](#recenzja-i-odbior).
|
|
13
13
|
|
|
14
|
+
Jeśli README w rejestrze jest puste, użyj lokalnych przewodników w `node_modules/robisie/docs/`. Metadane rejestru i publikacja wymagają osobnej pracy wydaniowej.
|
|
15
|
+
|
|
14
16
|
<!-- sekcja: wymagania -->
|
|
15
17
|
<a id="wymagania"></a>
|
|
16
18
|
## Wymagania
|
|
@@ -25,15 +27,23 @@ Przygotuj pusty katalog na dysku. Nie potrzebujesz strony ani własnego pliku `p
|
|
|
25
27
|
|
|
26
28
|
Człowiek loguje się na https://robisie.app przez Google albo link e-mail. Zaczekaj na ekran gotowości pierwszego projektu. Przy braku gotowości użyj odnośnika do https://robisie.app/dashboard/plugins/planer i przygotuj projekt w panelu; liczba prób sprawdzania gotowości nie jest gwarancją czasu przygotowania.
|
|
27
29
|
|
|
28
|
-
CEO wymaga, aby uwierzytelnione
|
|
30
|
+
Odczyt projektów to uwierzytelniony odczyt aktywnych projektów przez `list_projects`; klucz wyznacza, co agent widzi. CEO wymaga, aby uwierzytelnione `list_projects` zwróciło dokładnie jeden projekt. Projekt w panelu nie jest katalogiem na dysku: przed pracą potwierdź z CEO, że dotyczą tego samego celu. Przy zerze projektów człowiek sprawdza gotowość i fallback panelu; przy wielu porządkuje/archiwizuje nadmiarowe projekty, aż `list_projects` zwróci jeden. Wybór kliknięciem w panelu nie wiąże projektu dla CEO. Nie podawaj UUID projektu w rozmowie; CEO bierze identyfikator wyłącznie z `list_projects`. Wynik: jeden rozpoznany projekt, zanim agent zapisze cokolwiek.
|
|
29
31
|
|
|
30
32
|
<!-- sekcja: klucz -->
|
|
31
33
|
<a id="klucz"></a>
|
|
32
34
|
## Klucz w Connect
|
|
33
35
|
|
|
36
|
+
<!-- agent-consent:start -->
|
|
37
|
+
### Instrukcja dla agenta — jedna zgoda na przebieg
|
|
38
|
+
|
|
39
|
+
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ę.
|
|
40
|
+
|
|
41
|
+
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.
|
|
42
|
+
<!-- agent-consent:end -->
|
|
43
|
+
|
|
34
44
|
Człowiek w https://robisie.app/dashboard/connect wybiera `worker` i własną rozpoznawalną etykietę, np. „tester laptop”, następnie generuje klucz. Jest wyświetlany tylko raz: zachowaj go jak hasło. Człowiek przekazuje go poza rozmową do ukrytego pytania init, nigdy do czatu, karty, argumentu polecenia ani historii powłoki.
|
|
35
45
|
|
|
36
|
-
`worker` to minimalna droga: odczyt oraz tworzenie/zmiana projektów, ścieżek i kart, rezerwacja pracy; bez ustawiania `done` przez create/update. `observer` tylko czyta. `full` dodaje usuwanie oraz zamykanie spraw decyzyjnych; `owner_validator` ma ten sam poziom dostępu co full. `seeder` ma wąski dostęp do `get_task` i poprawnego zasiewu przez `append_detail`, bez `list_projects`/odczytu tablicy — nie uruchomi tego przewodnika.
|
|
46
|
+
`worker` to minimalna droga: odczyt oraz tworzenie/zmiana projektów, ścieżek i kart, rezerwacja pracy; bez ustawiania `done` przez create/update. `observer` tylko czyta. Za każdym razem jawnie wybierz `worker`: kolejne klucze mają domyślnie `observer` (ekran pierwszego klucza może wskazywać worker); nie wywodź uprawnień z wartości domyślnej. `full` dodaje usuwanie oraz zamykanie spraw decyzyjnych; `owner_validator` ma ten sam poziom dostępu co full. `seeder` ma wąski dostęp do `get_task` i poprawnego zasiewu przez `append_detail`, bez `list_projects`/odczytu tablicy — nie uruchomi tego przewodnika.
|
|
37
47
|
|
|
38
48
|
Paczka zapisuje **jeden klucz dla CEO, Buildera i Quality Officera** jako `ROBISIE_KEY`. Nazwa roli nie zmienia uprawnień. Nie używaj full jako obejścia odbioru `done`: właściciel odbiera wynik w panelu bez rozszerzania klucza agenta.
|
|
39
49
|
|
|
@@ -41,6 +51,10 @@ Paczka zapisuje **jeden klucz dla CEO, Buildera i Quality Officera** jako `ROBIS
|
|
|
41
51
|
<a id="instalacja"></a>
|
|
42
52
|
## Instalacja z npm
|
|
43
53
|
|
|
54
|
+
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.
|
|
55
|
+
|
|
56
|
+
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.
|
|
57
|
+
|
|
44
58
|
Po przygotowaniu konta i klucza człowiek otwiera terminal i wchodzi 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. Następnie: instalacja, init z ukrytym pytaniem o klucz, doctor. W zsh/bash usuń stary ENV przed init i wczytaj zapisany klucz przed doctor — init nie ustawia środowiska rodzica:
|
|
45
59
|
|
|
46
60
|
```sh
|
|
@@ -48,23 +62,67 @@ cd "/ścieżka/do/pustego katalogu" &&
|
|
|
48
62
|
node -e 'try {
|
|
49
63
|
require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
|
|
50
64
|
} catch (error) {
|
|
51
|
-
console.error(
|
|
65
|
+
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.");
|
|
52
66
|
process.exit(1);
|
|
53
67
|
}' &&
|
|
54
68
|
{
|
|
69
|
+
set +x
|
|
55
70
|
npm i robisie &&
|
|
56
71
|
unset ROBISIE_KEY &&
|
|
57
72
|
npx robisie init --agent claude &&
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
73
|
+
{
|
|
74
|
+
if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
75
|
+
[ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
76
|
+
[ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
77
|
+
ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
|
|
78
|
+
[ -n "$ROBISIE_KEY" ]; then
|
|
79
|
+
export ROBISIE_KEY
|
|
80
|
+
else
|
|
81
|
+
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
|
|
82
|
+
false
|
|
83
|
+
fi
|
|
84
|
+
} &&
|
|
61
85
|
npx robisie doctor
|
|
62
86
|
}
|
|
63
87
|
```
|
|
64
88
|
|
|
65
89
|
Łańcuch `&&` zatrzymuje blok po pierwszym błędzie; osobne przypisanie przed `export` zachowuje status odczytu klucza, więc doctor go nie maskuje. Po naprawieniu przyczyny ponów nieudany krok i wszystkie następne z bloku w tym samym katalogu. Jeśli manifest już powstał, nie ponawiaj jego tworzenia ani go nie usuwaj.
|
|
66
90
|
|
|
67
|
-
|
|
91
|
+
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ę.
|
|
92
|
+
|
|
93
|
+
<!-- reinstall:start -->
|
|
94
|
+
```sh
|
|
95
|
+
set +x
|
|
96
|
+
{
|
|
97
|
+
if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
98
|
+
[ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
99
|
+
[ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
100
|
+
ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
|
|
101
|
+
[ -n "$ROBISIE_KEY" ]; then
|
|
102
|
+
export ROBISIE_KEY
|
|
103
|
+
else
|
|
104
|
+
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
|
|
105
|
+
false
|
|
106
|
+
fi
|
|
107
|
+
} &&
|
|
108
|
+
node -e 'try {
|
|
109
|
+
const fs = require("node:fs");
|
|
110
|
+
let existing;
|
|
111
|
+
try { existing = fs.lstatSync("package.json"); }
|
|
112
|
+
catch (error) { if (error.code !== "ENOENT") throw error; }
|
|
113
|
+
if (existing) {
|
|
114
|
+
if (!existing.isFile()) throw new Error("package.json: wymagany zwykły plik; link i katalog odrzucone");
|
|
115
|
+
} else fs.writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
|
|
116
|
+
} catch (error) {
|
|
117
|
+
console.error(error.message);
|
|
118
|
+
console.error("Następny krok: sprawdź lokalnie package.json; zachowaj plik i wyjaśnij ścieżkę przed ponowieniem.");
|
|
119
|
+
process.exit(1);
|
|
120
|
+
}' &&
|
|
121
|
+
npm i robisie &&
|
|
122
|
+
npx robisie init &&
|
|
123
|
+
npx robisie doctor
|
|
124
|
+
```
|
|
125
|
+
<!-- reinstall:end -->
|
|
68
126
|
|
|
69
127
|
Dla Codex lub OpenCode zastąp `claude` przez `codex` lub `opencode`. Przy wcześniejszej konfiguracji użyj pełnej mapy z następnej sekcji; samo `--agent` jej nie kasuje. Oczekiwany wynik doctor: exit 0. Awaryjny zgodny tgz przygotuj według sekcji Aktualizacja. Pomocniki `client-launch-context` i `ceo-client-launcher` są konfigurowane przez init dla wersji paczki; lokalne wywołanie to `npx robisie mcp <nazwa>` z cwd instalacji. Wpisy agenta zachowują transport generowany przez paczkę; ta instrukcja go nie zmienia. npx może pobrać paczkę z sieci, gdy nie znajdzie wymaganej wersji lokalnie.
|
|
70
128
|
|
|
@@ -92,9 +150,19 @@ npx robisie init --agent opencode --role ceo=opencode --role builder=opencode --
|
|
|
92
150
|
Profil dotyczy tylko zsh/bash bez `--no-shell`. W innej powłoce lub przy `--no-shell` człowiek ustawia środowisko sesji agenta samodzielnie, bez ujawniania klucza. W powłoce POSIX można bezpiecznie wczytać zapisany plik:
|
|
93
151
|
|
|
94
152
|
```sh
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
153
|
+
set +x
|
|
154
|
+
{
|
|
155
|
+
if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
156
|
+
[ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
157
|
+
[ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
158
|
+
ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
|
|
159
|
+
[ -n "$ROBISIE_KEY" ]; then
|
|
160
|
+
export ROBISIE_KEY
|
|
161
|
+
else
|
|
162
|
+
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
|
|
163
|
+
false
|
|
164
|
+
fi
|
|
165
|
+
}
|
|
98
166
|
```
|
|
99
167
|
|
|
100
168
|
Nowy terminal sam nie gwarantuje klucza: zachowaj XDG_CONFIG_HOME z instalacji i sprawdź doctor w docelowej sesji. Jeśli OpenCode ma tylko `opencode.jsonc`, init odmawia przed zapisem. Sam wpis zdalnego MCP w jsonc nie instaluje ról ani pomocników. Zachowaj konfigurację; człowiek przygotowuje wspierany `opencode.json` bez komentarzy zgodnie z ustawieniami OpenCode albo wybiera innego zainstalowanego dostawcę dla wszystkich ról. Paczka nie konwertuje JSONC.
|
|
@@ -132,9 +200,9 @@ Doctor uruchamia plik pomocnika przez node, agent przez npx. `ROBISIE_PROJECT_CO
|
|
|
132
200
|
<!-- sekcja: pierwsza-karta -->
|
|
133
201
|
## Pierwsza karta i start Buildera
|
|
134
202
|
|
|
135
|
-
Człowiek uruchamia CEO w katalogu instalacji: `claude --agent ceo-client`, albo `codex` i prosi o rolę robisie CEO (odczyt pełnego pliku wskazanego w AGENTS.md), albo `opencode` i wybiera `ceo-client`. Po poprawnym
|
|
203
|
+
Człowiek uruchamia CEO w katalogu instalacji: `claude --agent ceo-client`, albo `codex` i prosi o rolę robisie CEO (odczyt pełnego pliku wskazanego w AGENTS.md), albo `opencode` i wybiera `ceo-client`. Po poprawnym odczycie projektów przekaż prośbę, która działa po instalacji npm z samym README:
|
|
136
204
|
|
|
137
|
-
> Utwórz w tym katalogu plik wynik.txt z dokładną treścią „robisie działa” i końcowym znakiem nowej linii. Sprawdź odczytem, że treść jest dokładnie taka. Granice: tylko ten plik, bez zależności, kont i publikacji.
|
|
205
|
+
> Utwórz w tym katalogu plik wynik.txt z dokładną treścią „robisie działa” i końcowym znakiem nowej linii. Sprawdź odczytem, że treść jest dokładnie taka. Granice: tylko ten plik, bez zależności, kont i publikacji. Korzystaj z mojej wcześniejszej zgody, jeśli obejmuje dokładnie ten zakres; w przeciwnym razie zapytaj przed pracą. Po pracy potrzebuję niezależnej recenzji i osobnego końcowego odbioru.
|
|
138
206
|
|
|
139
207
|
Po zgodzie człowieka CEO domyślnie wywołuje `spawn_builder` z ID karty potwierdzonej w `ready`. Pełny przebieg w Claude Code: `draft` → `ready` → `in_progress` → `in_review` → niezależna recenzja i verified receipt → `delivered` → odbiór właściciela → `done`; granice odbioru dla pozostałych sesji opisuje sekcja [Recenzja i jawny odbiór](#recenzja-i-odbior).
|
|
140
208
|
|
|
@@ -160,13 +228,25 @@ W Claude Code CEO uruchamia niezależnego Quality Officera przez `Agent(quality-
|
|
|
160
228
|
|
|
161
229
|
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 wyżej ścieżki w Claude Code. Wynik task/VERIFIED, etykieta roli ani sam JSON receiptu nie otwierają tego przejścia; nie obchodź odmowy ręczną zmianą statusu ani samorecenzją.
|
|
162
230
|
|
|
163
|
-
W innych sesjach CEO, w tym 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`: to brak zdolności produktu wymagający naprawy CEO
|
|
231
|
+
W innych sesjach CEO, w tym 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`: to brak zdolności produktu wymagający naprawy przez osobę odpowiedzialną za integrację CEO. Nie zastępuj recenzji oceną Buildera ani ręczną zmianą etapu. Sama konfiguracja trzech ról nie zapewnia tej integracji.
|
|
164
232
|
|
|
165
233
|
Właściciel projektu może w panelu: Dashboard → Planer → karta → Etap wybrać „Zrobione” i przesunąć `delivered` do `done`, także przy kluczu agenta `worker`. Dla opisanej pierwszej karty serwer nie wymusza zapisanej akceptacji ani dowodów przed zmianą na `done`: panel pozwala właścicielowi wybrać „Zrobione” także bez nich. Zrób to dopiero po sprawdzeniu wyniku i jawnym odbiorze. Panel nie edytuje szczegółów `details`; recenzję i dowody zapisuje się przez obsługiwany przepływ narzędzi tablicy. Sama instrukcja nie dowodzi, że ten przebieg przeszedł już u klienta.
|
|
166
234
|
|
|
167
235
|
<!-- sekcja: aktualizacja -->
|
|
168
236
|
## Aktualizacja i prywatna kopia
|
|
169
237
|
|
|
238
|
+
### Aktualizacja przed pierwszym init
|
|
239
|
+
|
|
240
|
+
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.
|
|
241
|
+
|
|
242
|
+
<!-- before-init-update:start -->
|
|
243
|
+
```sh
|
|
244
|
+
npm i robisie@latest
|
|
245
|
+
```
|
|
246
|
+
<!-- before-init-update:end -->
|
|
247
|
+
|
|
248
|
+
### Aktualizacja po init
|
|
249
|
+
|
|
170
250
|
Pracuj w katalogu instalacji. Najpierw przygotuj kopię poniżej. Wybierz jawnie poprzednią, zgodną z MAJOR kontraktu serwera wersję; sprawdź zainstalowaną przez `node -p 'require("./node_modules/robisie/package.json").version'`. Przykład `previous_version='0.1.1'` zastąp tą wybraną wersją. `npm pack robisie@<wersja>` pobiera właśnie to wydanie, nie przypadkowy plik tgz; zachowaj jego nazwę i katalog kopii. Nie wykonuj przepisu z włączonym xtrace, nie drukuj ani nie wklejaj sekretów.
|
|
171
251
|
|
|
172
252
|
```sh
|
|
@@ -186,32 +266,66 @@ Zachowaj te same wartości HOME, XDG_CONFIG_HOME i CODEX_HOME co podczas instala
|
|
|
186
266
|
|
|
187
267
|
Brak/null/pusta/wadliwa konfiguracja projektu lub ewidencja nie daje gwarancji restore. Zachowaj dostępne dane, uruchom lokalny `npx robisie doctor` i zastosuj jego poradę; nowy init nie odtworzy brakującej ewidencji. Przy błędzie ewidencji lub odczytu klucza rozwiąż go przed błędami sieci. Nie zamieniaj uszkodzonej ewidencji na pustą.
|
|
188
268
|
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
269
|
+
Przejdź cztery kroki; pary poleceń to ściąga wyboru plików, nie dwadzieścia obowiązkowych kopii:
|
|
270
|
+
|
|
271
|
+
1. Zachowaj manifesty projektu (`package.json` i `package-lock.json`), konfigurację projektu oraz ewidencję/klucz robisie. Braki odnotuj w `absent.txt`.
|
|
272
|
+
2. Z `manifest.entries` wybierz tylko użytych dostawców, zapisany profil, role i wcześniejsze backupy. Zastosuj wszystkie kontrole ścieżek, typu i odczytu opisane poniżej.
|
|
273
|
+
3. Wykonaj i sprawdź tylko te kopie; zachowaj prywatnie ich ścieżki oraz tgz wybranego wydania.
|
|
274
|
+
4. Aktualizuj dopiero po wykonaniu kopii. Przy powrocie porównaj późniejsze zmiany i przywróć OBA manifesty projektu przed komendą tgz, potem klucz → instalacja tgz → init → doctor.
|
|
275
|
+
|
|
276
|
+
Poniższe bloki to osobne komendy do ręcznego wyboru, nie blok do uruchomienia w całości. Kopiuj pliki projektu i robisie oraz tylko użytych dostawców z ewidencji, nigdy całe `~/.claude/`, `CODEX_HOME` ani katalog OpenCode. Dla każdego źródła i celu oraz ich katalogów nadrzędnych sprawdź wcześniej typ i odczyt. Dla `backups/` i `roles/codex/` sprawdź również wszystkie elementy wewnątrz. Nieczytelny plik/wpis lub dowiązanie (także wiszące, również w katalogu nadrzędnym) zatrzymuje przepis: zachowaj stan i porównaj ścieżki, bez ślepego cp przez link. Katalog w miejscu oczekiwanego pliku także wymaga wyjaśnienia. Jeśli pliku nie ma, odnotuj jego pełną ścieżkę w `$backup/absent.txt`, np. `printf '%s\n' "$PWD/robisie.config.json" >> "$backup/absent.txt"`; pomiń cp w obie strony. Przy restore nie kasuj plików, które powstały później.
|
|
277
|
+
|
|
278
|
+
`profile` ustaw na faktycznie zmieniony profil z manifest.entries: zsh `${ZDOTDIR:-$HOME}/.zshrc`; bash na macOS pierwszy czytelny `$HOME/.bash_profile`, `$HOME/.bash_login`, `$HOME/.profile` (gdy żaden nie istnieje, `.bash_profile`); bash poza macOS `$HOME/.bashrc`. Przy `--no-shell`/innej powłoce nie dopisuj nowego profilu; zachowaj jednak wcześniejszy wpis profilu, jeśli jest w ewidencji. Każdy dodatkowy `path` i `backup` z entries skopiuj oddzielnie: ustaw `entry_path` na dokładną absolutną ścieżkę, `entry_id` na własny unikalny numer i zanotuj parę w prywatnej kopii. Parę entry_path powtórz dla każdego takiego pliku. Nie zakładaj, że lista domyślna pokrywa poprzednie instalacje i dostawców. Utwórz tylko potrzebne brakujące katalogi docelowe po tej samej kontroli ścieżek.
|
|
279
|
+
|
|
280
|
+
Kopia: wybierz tylko potrzebne polecenia i sprawdź wynik każdego.
|
|
281
|
+
|
|
282
|
+
```sh
|
|
283
|
+
cp -p -- "$PWD/package.json" "$backup/project/package.json"
|
|
284
|
+
cp -p -- "$PWD/package-lock.json" "$backup/project/package-lock.json"
|
|
285
|
+
cp -p -- "$PWD/robisie.config.json" "$backup/project/robisie.config.json"
|
|
286
|
+
cp -p -- "$config_home/robisie/key" "$backup/robisie/key"
|
|
287
|
+
cp -p -- "$config_home/robisie/manifest.json" "$backup/robisie/manifest.json"
|
|
288
|
+
cp -Rp -- "$config_home/robisie/backups/." "$backup/robisie/backups/"
|
|
289
|
+
cp -Rp -- "$config_home/robisie/roles/codex/." "$backup/robisie/roles/codex/"
|
|
290
|
+
cp -p -- "$HOME/.claude.json" "$backup/claude/claude.json"
|
|
291
|
+
cp -p -- "$HOME/.claude/agents/ceo-client.md" "$backup/claude/agents/ceo-client.md"
|
|
292
|
+
cp -p -- "$HOME/.claude/agents/manager-builder-client.md" "$backup/claude/agents/manager-builder-client.md"
|
|
293
|
+
cp -p -- "$HOME/.claude/agents/quality-officer-client.md" "$backup/claude/agents/quality-officer-client.md"
|
|
294
|
+
cp -p -- "$codex_home/config.toml" "$backup/codex/config.toml"
|
|
295
|
+
cp -p -- "$codex_home/AGENTS.md" "$backup/codex/AGENTS.md"
|
|
296
|
+
cp -p -- "$config_home/opencode/opencode.json" "$backup/opencode/opencode.json"
|
|
297
|
+
cp -p -- "$config_home/opencode/agents/ceo-client.md" "$backup/opencode/agents/ceo-client.md"
|
|
298
|
+
cp -p -- "$config_home/opencode/agents/manager-builder-client.md" "$backup/opencode/agents/manager-builder-client.md"
|
|
299
|
+
cp -p -- "$config_home/opencode/agents/quality-officer-client.md" "$backup/opencode/agents/quality-officer-client.md"
|
|
300
|
+
cp -p -- "$config_home/opencode/plugins/robisie-review-guard.js" "$backup/opencode/plugins/robisie-review-guard.js"
|
|
301
|
+
cp -p -- "$profile" "$backup/profile/selected"
|
|
302
|
+
cp -p -- "$entry_path" "$backup/entries/$entry_id"
|
|
303
|
+
```
|
|
304
|
+
|
|
305
|
+
Przywracanie: te same pary źródło/kopia w tej samej kolejności, dopiero po porównaniu.
|
|
306
|
+
|
|
307
|
+
```sh
|
|
308
|
+
cp -p -- "$backup/project/package.json" "$PWD/package.json"
|
|
309
|
+
cp -p -- "$backup/project/package-lock.json" "$PWD/package-lock.json"
|
|
310
|
+
cp -p -- "$backup/project/robisie.config.json" "$PWD/robisie.config.json"
|
|
311
|
+
cp -p -- "$backup/robisie/key" "$config_home/robisie/key"
|
|
312
|
+
cp -p -- "$backup/robisie/manifest.json" "$config_home/robisie/manifest.json"
|
|
313
|
+
cp -Rp -- "$backup/robisie/backups/." "$config_home/robisie/backups/"
|
|
314
|
+
cp -Rp -- "$backup/robisie/roles/codex/." "$config_home/robisie/roles/codex/"
|
|
315
|
+
cp -p -- "$backup/claude/claude.json" "$HOME/.claude.json"
|
|
316
|
+
cp -p -- "$backup/claude/agents/ceo-client.md" "$HOME/.claude/agents/ceo-client.md"
|
|
317
|
+
cp -p -- "$backup/claude/agents/manager-builder-client.md" "$HOME/.claude/agents/manager-builder-client.md"
|
|
318
|
+
cp -p -- "$backup/claude/agents/quality-officer-client.md" "$HOME/.claude/agents/quality-officer-client.md"
|
|
319
|
+
cp -p -- "$backup/codex/config.toml" "$codex_home/config.toml"
|
|
320
|
+
cp -p -- "$backup/codex/AGENTS.md" "$codex_home/AGENTS.md"
|
|
321
|
+
cp -p -- "$backup/opencode/opencode.json" "$config_home/opencode/opencode.json"
|
|
322
|
+
cp -p -- "$backup/opencode/agents/ceo-client.md" "$config_home/opencode/agents/ceo-client.md"
|
|
323
|
+
cp -p -- "$backup/opencode/agents/manager-builder-client.md" "$config_home/opencode/agents/manager-builder-client.md"
|
|
324
|
+
cp -p -- "$backup/opencode/agents/quality-officer-client.md" "$config_home/opencode/agents/quality-officer-client.md"
|
|
325
|
+
cp -p -- "$backup/opencode/plugins/robisie-review-guard.js" "$config_home/opencode/plugins/robisie-review-guard.js"
|
|
326
|
+
cp -p -- "$backup/profile/selected" "$profile"
|
|
327
|
+
cp -p -- "$backup/entries/$entry_id" "$entry_path"
|
|
328
|
+
```
|
|
215
329
|
|
|
216
330
|
Gdy tgz i wszystkie wybrane kopie są gotowe, aktualizuj. Init nie czyta pliku key automatycznie: pierwszeństwo ma ROBISIE_KEY, potem ukryte pytanie w terminalu, potem jawny `--key-stdin` (np. automatyzacja bez terminala). Sam plik key nie wystarcza. Wczytaj stary klucz PRZED init/doctor z tego samego XDG_CONFIG_HOME; osobne przypisanie przed export i `&&` zachowują błąd odczytu bez wydruku klucza:
|
|
217
331
|
|
|
@@ -220,11 +334,18 @@ Gdy tgz i wszystkie wybrane kopie są gotowe, aktualizuj. Init nie czyta pliku k
|
|
|
220
334
|
set +x
|
|
221
335
|
XDG_CONFIG_HOME="$config_home" &&
|
|
222
336
|
export XDG_CONFIG_HOME &&
|
|
223
|
-
|
|
224
|
-
[ -
|
|
225
|
-
[ -
|
|
226
|
-
|
|
227
|
-
|
|
337
|
+
{
|
|
338
|
+
if [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
|
|
339
|
+
[ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
|
|
340
|
+
[ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
|
|
341
|
+
ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key" 2>/dev/null)" &&
|
|
342
|
+
[ -n "$ROBISIE_KEY" ]; then
|
|
343
|
+
export ROBISIE_KEY
|
|
344
|
+
else
|
|
345
|
+
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
|
|
346
|
+
false
|
|
347
|
+
fi
|
|
348
|
+
} &&
|
|
228
349
|
npm i robisie@latest &&
|
|
229
350
|
npx robisie init &&
|
|
230
351
|
npx robisie doctor
|
|
@@ -235,21 +356,28 @@ Doctor sprawdza MAJOR kontraktu; exit 0 wymaga także pozostałych kontroli. Prz
|
|
|
235
356
|
|
|
236
357
|
### Powrót do poprzedniego wydania
|
|
237
358
|
|
|
238
|
-
Przed nadpisaniem zachowaj późniejsze własne zmiany w NOWEJ prywatnej kopii (`umask 077`, np. `later="$(mktemp -d "$HOME/robisie-later.XXXXXX")"`). Powtórz przygotowanie katalogów i
|
|
359
|
+
Przed nadpisaniem zachowaj późniejsze własne zmiany w NOWEJ prywatnej kopii (`umask 077`, np. `later="$(mktemp -d "$HOME/robisie-later.XXXXXX")"`). Powtórz przygotowanie katalogów i blok kopii, podstawiając `$later` zamiast `$backup`, bez zmiany starej kopii. Porównaj lokalnie i scal własne zmiany z kopią poprzedniego wydania; konfiguracja może zawierać klucz, więc bez publikowania diffu. Przy nieczytelnej konfiguracji, linku lub nierozstrzygniętym porównaniu przerwij nadpisywanie. Nie ma obietnicy automatycznego rollbacku.
|
|
239
360
|
|
|
240
|
-
Po porównaniu wykonaj wybrane komendy z
|
|
361
|
+
Po porównaniu wykonaj wybrane komendy z bloku przywracania do tych samych celów, zachowując pominięcia z absent.txt. Polecenia katalogów kopiują zawartość przez `/.`, bez zagnieżdżania kolejnego katalogu; przed restore przygotuj sprawdzone katalogi celów, jeśli ich brakuje. Przy scalaniu `backups/` i `roles/codex/` nie usuwaj dodatkowych późniejszych plików. Najpierw przywróć `package.json` ORAZ `package-lock.json`. Potem w tym samym cwd wczytaj przywrócony stary klucz do ENV, zainstaluj zachowany zgodny tgz i dopiero wykonaj init oraz doctor:
|
|
241
362
|
|
|
242
363
|
<!-- restore:start -->
|
|
243
364
|
```sh
|
|
244
365
|
set +x
|
|
245
|
-
npm i --no-save "$backup/robisie-$previous_version.tgz" &&
|
|
246
366
|
XDG_CONFIG_HOME="$config_home" &&
|
|
247
367
|
export XDG_CONFIG_HOME &&
|
|
248
|
-
|
|
249
|
-
[ -
|
|
250
|
-
[ -
|
|
251
|
-
|
|
252
|
-
|
|
368
|
+
{
|
|
369
|
+
if [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
|
|
370
|
+
[ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
|
|
371
|
+
[ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
|
|
372
|
+
ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key" 2>/dev/null)" &&
|
|
373
|
+
[ -n "$ROBISIE_KEY" ]; then
|
|
374
|
+
export ROBISIE_KEY
|
|
375
|
+
else
|
|
376
|
+
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
|
|
377
|
+
false
|
|
378
|
+
fi
|
|
379
|
+
} &&
|
|
380
|
+
npm i --no-save "$backup/robisie-$previous_version.tgz" &&
|
|
253
381
|
npx robisie init &&
|
|
254
382
|
npx robisie doctor
|
|
255
383
|
```
|
|
@@ -257,7 +385,7 @@ npx robisie doctor
|
|
|
257
385
|
|
|
258
386
|
Opcja `--no-save` zachowuje przywrócone `package.json` i `package-lock.json`, bez zapisywania zależności `file:` od ścieżki prywatnej kopii.
|
|
259
387
|
|
|
260
|
-
Po każdej osobnej komendzie
|
|
388
|
+
Po każdej osobnej wybranej komendzie sprawdź jej status; błąd zatrzymuje przepis. Łańcuch zatrzymuje się sam. Nie maskuj odczytu ani nie łącz przypisania klucza z export. W razie błędu zachowaj obie kopie i skorzystaj z porady doctor, bez dalszego nadpisywania.
|
|
261
389
|
|
|
262
390
|
<!-- sekcja: odinstalowanie -->
|
|
263
391
|
## Odinstalowanie
|
|
@@ -269,6 +397,8 @@ npm uninstall robisie
|
|
|
269
397
|
|
|
270
398
|
Pierwsza komenda usuwa wpisy i bloki robisie z plików zapisanych w rejestrze instalacji oraz cofa role. Nie przywraca starych wpisów robisie. Zmienione przez użytkownika role zostają z ostrzeżeniem; kopie zapasowe pozostają i mogą zawierać stary klucz. Bez zapisu instalacji komenda niczego nie zmienia i **nie usuwa pliku klucza**. Odmowa podczas sprawdzania konfiguracji Codex następuje **przed usunięciem klucza**; po tym sprawdzeniu plik klucza jest usuwany, nawet jeśli późniejsze cofanie zmian się nie uda. Kod różny od zera wymaga zachowania własnych zmian i rozwiązania wskazanego problemu przed ponowieniem. Otwórz nowy terminal. Odinstalowanie nie unieważnia klucza na serwerze: unieważnij go osobno w Connect. Druga komenda usuwa paczkę z projektu i może zmienić `package.json`, `package-lock.json` oraz `node_modules`; cache npm może pozostać. Nie kasuj masowo tych plików ani cache. Późniejsze npx może ponownie pobrać paczkę z sieci.
|
|
271
399
|
|
|
400
|
+
Zachowane backupy, także prywatne kopie aktualizacji, mogą nadal zawierać klucz po uninstall. Przechowuj je prywatnie zgodnie z własną retencją; uninstall nie wymazuje ani nie unieważnia tych kopii. Ta instrukcja nie kasuje ich automatycznie.
|
|
401
|
+
|
|
272
402
|
<!-- sekcja: diagnoza -->
|
|
273
403
|
## Diagnoza
|
|
274
404
|
|
|
@@ -276,17 +406,24 @@ Bez instalacji zacznij od konta i Connect → init; samo ponawianie doctor nie z
|
|
|
276
406
|
|
|
277
407
|
Komunikaty CLI pozostają po polsku. Dopasuj komunikat, a potem wykonaj wskazaną czynność:
|
|
278
408
|
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
409
|
+
- **brak-klucza** — `Brak klucza robisie.`
|
|
410
|
+
Wygeneruj klucz w Connect i przekaż go do init.
|
|
411
|
+
- **odrzucony-klucz** — `Serwer robisie odrzucił klucz (nieważny albo unieważniony).`
|
|
412
|
+
Wygeneruj nowy klucz worker; w zsh/bash wykonaj `unset ROBISIE_KEY`, potem init z ukrytym pytaniem.
|
|
413
|
+
- **brak-odczytu** — `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).`
|
|
414
|
+
Wybierz worker w Connect; `unset ROBISIE_KEY`, potem init z ukrytym pytaniem.
|
|
415
|
+
- **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.1.4 (obsługuje 1.x).`
|
|
416
|
+
Przykład niezgodnego MAJOR: zainstaluj wydanie zgodne z kontraktem serwera.
|
|
417
|
+
- **brak-env** — `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.`
|
|
418
|
+
Sprawdź obsługę profilu; przy --no-shell/innej powłoce wczytaj plik klucza do środowiska sesji jak w init, potem doctor.
|
|
419
|
+
- **brak-programu** — `katalog jest, programu nie ma w PATH`
|
|
420
|
+
Zainstaluj program wskazanego dostawcy lub dodaj go do PATH; sam katalog konfiguracji nie wystarcza.
|
|
421
|
+
- **brak-programu-i-katalogu** — `brak programu w PATH i katalogu dostawcy`
|
|
422
|
+
Zainstaluj wybrany program, ponów init z pełną wspólną mapą i doctor.
|
|
423
|
+
- **jsonc** — `nie zmieniam automatycznie`
|
|
424
|
+
Zachowaj JSONC; przygotuj wspierany JSON albo wybierz innego dostawcę dla wszystkich ról. Sam zdalny MCP nie wystarcza.
|
|
425
|
+
- **niepelna-instalacja** — `Claude Code: niepełna instalacja`
|
|
426
|
+
Przykład brakującej konfiguracji: ponów init dla swojego agenta.
|
|
290
427
|
|
|
291
428
|
Po naprawie przy istniejącej ewidencji wczytaj zapisany klucz według Aktualizacji przed lokalnym `npx robisie init` i `npx robisie doctor`; przy braku plików paczki przeinstaluj ją z npm, przy MAJOR uzyskaj zgodne wydanie. Przy braku ewidencji zachowaj dane i zastosuj poradę doctor zamiast init w ciemno. Jeśli problem pozostaje, przekaż zespołowi komunikat, wersję i cwd bez klucza. Przy uninstall wynik to usunięte wpisy i exit 0; kod 1 wymaga wskazanej naprawy, nie oznacza pełnego usunięcia.
|
|
292
429
|
|
package/docs/RELEASE-0.1.0.md
CHANGED
|
@@ -88,9 +88,11 @@ export const config = parseConfig({
|
|
|
88
88
|
- `dist/role-registry.js`
|
|
89
89
|
- `dist/role-results.js`
|
|
90
90
|
- `dist/roles.js`
|
|
91
|
+
- `dist/seed-package.js`
|
|
91
92
|
- `dist/seed-validation.js`
|
|
92
93
|
- `dist/selection-result.js`
|
|
93
94
|
- `dist/sparse-policy.js`
|
|
95
|
+
- `dist/task-mktemp.js`
|
|
94
96
|
- `dist/tester-identity.js`
|
|
95
97
|
- `dist/worker-env.js`
|
|
96
98
|
- `helpers/ceo-client-launcher-mcp.mjs` → `spawn_builder`
|
package/package.json
CHANGED