robisie 0.1.1 → 0.1.3
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 +18 -0
- package/README.md +101 -13
- package/dist/cli.js +17 -13
- package/dist/commands.js +8 -6
- package/dist/constants.d.ts +1 -1
- package/dist/constants.js +1 -1
- package/dist/helpers.js +17 -11
- package/dist/mcp.js +48 -21
- package/dist/opencode-result.js +1 -1
- package/dist/role-registry.d.ts +7 -1
- package/dist/role-registry.js +11 -3
- package/dist/roles.d.ts +1 -1
- package/docs/ENGINE-API.md +12 -2
- package/docs/ENGINE-CONFIG.md +9 -11
- package/docs/README.en.md +211 -17
- package/docs/README.md +211 -17
- 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.3)
|
|
2
2
|
|
|
3
3
|
English: [README.en.md](README.en.md).
|
|
4
4
|
|
|
@@ -7,15 +7,19 @@ 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. 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
|
+
|
|
10
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).
|
|
11
13
|
|
|
14
|
+
Wpis CHANGELOG o readback README z rejestru opisuje kontrolę wydania, nie dowód niepustego README konkretnej publikacji. E4 wykazał pusty README w rejestrze przy przewodnikach obecnych w tarballu; lokalnie użyj `node_modules/robisie/docs/`. Metadane rejestru, publikacja i korekta historii CHANGELOG wymagają osobnej pracy wydaniowej.
|
|
15
|
+
|
|
12
16
|
<!-- sekcja: wymagania -->
|
|
13
17
|
<a id="wymagania"></a>
|
|
14
18
|
## Wymagania
|
|
15
19
|
|
|
16
|
-
Człowiek przygotowuje Node.js 20+, npm, internet do zależności i robisie oraz program jednego dostawcy: Claude Code, Codex CLI albo OpenCode z własnym dostępem do AI. Sprawdź `node --version`, `npm --version` i wersję wybranego programu (`claude --version`, `codex --version` lub `opencode --version`). Jeśli programu nie ma w PATH, zainstaluj go według instrukcji dostawcy i sprawdź ponownie; sam katalog konfiguracji nie wystarcza.
|
|
20
|
+
Człowiek przygotowuje Node.js 20+, npm, internet do zależności i robisie oraz program jednego dostawcy: Claude Code, Codex CLI albo OpenCode z własnym dostępem do AI. Sprawdź `node --version`, `npm --version` i wersję wybranego programu (`claude --version`, `codex --version` lub `opencode --version`). Jeśli programu nie ma w PATH, zainstaluj go według instrukcji dostawcy i sprawdź ponownie; sam katalog konfiguracji nie wystarcza. Windows/WSL są niezweryfikowane; poniższe przykłady używają ścieżek POSIX.
|
|
17
21
|
|
|
18
|
-
Przygotuj pusty katalog na dysku. Nie potrzebujesz strony ani pliku `package.json`;
|
|
22
|
+
Przygotuj pusty katalog na dysku. Nie potrzebujesz strony ani własnego pliku `package.json`; przed instalacją utworzy go poniższy krok Node.js. To katalog pracy agentów, niezależny od projektu w panelu.
|
|
19
23
|
|
|
20
24
|
<!-- sekcja: konto -->
|
|
21
25
|
<a id="konto"></a>
|
|
@@ -23,15 +27,17 @@ Przygotuj pusty katalog na dysku. Nie potrzebujesz strony ani pliku `package.jso
|
|
|
23
27
|
|
|
24
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.
|
|
25
29
|
|
|
26
|
-
CEO wymaga, aby uwierzytelnione discovery 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ż discovery 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 discovery. Wynik: jeden rozpoznany projekt, zanim agent zapisze cokolwiek.
|
|
30
|
+
Discovery to uwierzytelniony odczyt aktywnych projektów przez `list_projects`; klucz wyznacza, co agent widzi. CEO wymaga, aby uwierzytelnione discovery 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ż discovery 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 discovery. Wynik: jeden rozpoznany projekt, zanim agent zapisze cokolwiek.
|
|
27
31
|
|
|
28
32
|
<!-- sekcja: klucz -->
|
|
29
33
|
<a id="klucz"></a>
|
|
30
34
|
## Klucz w Connect
|
|
31
35
|
|
|
36
|
+
Agent może sam założyć konto i wygenerować klucz na własnym koncie, w granicach zgody jego właściciela. Logowanie lub inny chroniony krok może wymagać potwierdzenia człowieka; po nim kontynuuj. Cudza otwarta sesja nie uprawnia do korzystania z jej konta ani klucza. Sekret pozostaje poza rozmową i historią poleceń; jeśli dostępne narzędzia nie pozwalają przekazać go bezpiecznie, człowiek wpisuje go w ukrytym pytaniu init.
|
|
37
|
+
|
|
32
38
|
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.
|
|
33
39
|
|
|
34
|
-
`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.
|
|
40
|
+
`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.
|
|
35
41
|
|
|
36
42
|
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.
|
|
37
43
|
|
|
@@ -39,17 +45,76 @@ Paczka zapisuje **jeden klucz dla CEO, Buildera i Quality Officera** jako `ROBIS
|
|
|
39
45
|
<a id="instalacja"></a>
|
|
40
46
|
## Instalacja z npm
|
|
41
47
|
|
|
42
|
-
Po przygotowaniu konta i klucza człowiek otwiera terminal
|
|
48
|
+
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. EEXIST oznacza istniejącą ścieżkę: wybierz drogę istniejącego projektu poniżej; link/katalog wymaga wyjaśnienia. 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:
|
|
43
49
|
|
|
44
50
|
```sh
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
51
|
+
cd "/ścieżka/do/pustego katalogu" &&
|
|
52
|
+
node -e 'try {
|
|
53
|
+
require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
|
|
54
|
+
} catch (error) {
|
|
55
|
+
console.error(error.message);
|
|
56
|
+
process.exit(1);
|
|
57
|
+
}' &&
|
|
58
|
+
{
|
|
59
|
+
set +x
|
|
60
|
+
npm i robisie &&
|
|
61
|
+
unset ROBISIE_KEY &&
|
|
62
|
+
npx robisie init --agent claude &&
|
|
63
|
+
{
|
|
64
|
+
if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
65
|
+
[ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
66
|
+
[ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
67
|
+
ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
|
|
68
|
+
[ -n "$ROBISIE_KEY" ]; then
|
|
69
|
+
export ROBISIE_KEY
|
|
70
|
+
else
|
|
71
|
+
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
|
|
72
|
+
false
|
|
73
|
+
fi
|
|
74
|
+
} &&
|
|
49
75
|
npx robisie doctor
|
|
76
|
+
}
|
|
50
77
|
```
|
|
51
78
|
|
|
52
|
-
|
|
79
|
+
Ł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.
|
|
80
|
+
|
|
81
|
+
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, 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ę.
|
|
82
|
+
|
|
83
|
+
<!-- reinstall:start -->
|
|
84
|
+
```sh
|
|
85
|
+
set +x
|
|
86
|
+
{
|
|
87
|
+
if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
88
|
+
[ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
89
|
+
[ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
90
|
+
ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
|
|
91
|
+
[ -n "$ROBISIE_KEY" ]; then
|
|
92
|
+
export ROBISIE_KEY
|
|
93
|
+
else
|
|
94
|
+
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
|
|
95
|
+
false
|
|
96
|
+
fi
|
|
97
|
+
} &&
|
|
98
|
+
node -e 'try {
|
|
99
|
+
const fs = require("node:fs");
|
|
100
|
+
let existing;
|
|
101
|
+
try { existing = fs.lstatSync("package.json"); }
|
|
102
|
+
catch (error) { if (error.code !== "ENOENT") throw error; }
|
|
103
|
+
if (existing) {
|
|
104
|
+
if (!existing.isFile()) throw new Error("package.json: wymagany zwykły plik; link i katalog odrzucone");
|
|
105
|
+
} else fs.writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
|
|
106
|
+
} catch (error) {
|
|
107
|
+
console.error(error.message);
|
|
108
|
+
console.error("Następny krok: sprawdź lokalnie package.json; zachowaj plik i wyjaśnij ścieżkę przed ponowieniem.");
|
|
109
|
+
process.exit(1);
|
|
110
|
+
}' &&
|
|
111
|
+
npm i robisie &&
|
|
112
|
+
npx robisie init &&
|
|
113
|
+
npx robisie doctor
|
|
114
|
+
```
|
|
115
|
+
<!-- reinstall:end -->
|
|
116
|
+
|
|
117
|
+
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.
|
|
53
118
|
|
|
54
119
|
<!-- sekcja: init -->
|
|
55
120
|
## Połączenie agenta
|
|
@@ -75,7 +140,19 @@ npx robisie init --agent opencode --role ceo=opencode --role builder=opencode --
|
|
|
75
140
|
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:
|
|
76
141
|
|
|
77
142
|
```sh
|
|
78
|
-
|
|
143
|
+
set +x
|
|
144
|
+
{
|
|
145
|
+
if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
146
|
+
[ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
147
|
+
[ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
|
|
148
|
+
ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
|
|
149
|
+
[ -n "$ROBISIE_KEY" ]; then
|
|
150
|
+
export ROBISIE_KEY
|
|
151
|
+
else
|
|
152
|
+
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
|
|
153
|
+
false
|
|
154
|
+
fi
|
|
155
|
+
}
|
|
79
156
|
```
|
|
80
157
|
|
|
81
158
|
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.
|
|
@@ -146,9 +223,120 @@ W innych sesjach CEO, w tym Codex, przejście do delivered wymaga niezależnej r
|
|
|
146
223
|
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.
|
|
147
224
|
|
|
148
225
|
<!-- sekcja: aktualizacja -->
|
|
149
|
-
## Aktualizacja
|
|
226
|
+
## Aktualizacja i prywatna kopia
|
|
227
|
+
|
|
228
|
+
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.
|
|
229
|
+
|
|
230
|
+
```sh
|
|
231
|
+
set +x
|
|
232
|
+
umask 077 &&
|
|
233
|
+
config_home="${XDG_CONFIG_HOME:-$HOME/.config}" &&
|
|
234
|
+
codex_home="${CODEX_HOME:-$HOME/.codex}" &&
|
|
235
|
+
backup="$(mktemp -d "$HOME/robisie-backup.XXXXXX")" &&
|
|
236
|
+
mkdir -p "$backup/project" "$backup/robisie/backups" "$backup/robisie/roles/codex" \
|
|
237
|
+
"$backup/claude/agents" "$backup/codex" "$backup/opencode/agents" \
|
|
238
|
+
"$backup/opencode/plugins" "$backup/profile" "$backup/entries" &&
|
|
239
|
+
previous_version='0.1.1' &&
|
|
240
|
+
npm pack "robisie@$previous_version" --pack-destination "$backup"
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
Zachowaj te same wartości HOME, XDG_CONFIG_HOME i CODEX_HOME co podczas instalacji (gdy ENV brak, powyżej używane są domyślne HOME). Nie zmieniaj ich podczas powrotu. Sprawdź lokalny `$config_home/robisie/manifest.json`: `manifest.entries` wskazuje faktyczne ścieżki `path` i wcześniejsze kopie `backup`. Nie wypisuj treści konfiguracji z kluczem do czatu. Czytelny legacy manifest bez roleProviders nadal ma użyteczne entries; sama starsza postać nie wymaga nowej instalacji. `roleProviders: null` oznacza brak przypisania — doctor poda dalszy krok, bez zgadywania mapy.
|
|
244
|
+
|
|
245
|
+
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ą.
|
|
246
|
+
|
|
247
|
+
Przejdź cztery kroki; tabela to ściąga wyboru plików, nie dwadzieścia obowiązkowych kopii:
|
|
248
|
+
|
|
249
|
+
1. Zachowaj manifesty projektu (`package.json` i `package-lock.json`), konfigurację projektu oraz ewidencję/klucz robisie. Braki odnotuj w `absent.txt`.
|
|
250
|
+
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.
|
|
251
|
+
3. Wykonaj i sprawdź tylko te kopie; zachowaj prywatnie ich ścieżki oraz tgz wybranego wydania.
|
|
252
|
+
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.
|
|
253
|
+
|
|
254
|
+
Poniższa tabela 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.
|
|
255
|
+
|
|
256
|
+
`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. Ostatni wiersz 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.
|
|
257
|
+
|
|
258
|
+
| Źródło → prywatna kopia (przed aktualizacją) | Kopia → cel restore (dopiero po porównaniu) |
|
|
259
|
+
|---|---|
|
|
260
|
+
| `cp -p -- "$PWD/package.json" "$backup/project/package.json"` | `cp -p -- "$backup/project/package.json" "$PWD/package.json"` |
|
|
261
|
+
| `cp -p -- "$PWD/package-lock.json" "$backup/project/package-lock.json"` | `cp -p -- "$backup/project/package-lock.json" "$PWD/package-lock.json"` |
|
|
262
|
+
| `cp -p -- "$PWD/robisie.config.json" "$backup/project/robisie.config.json"` | `cp -p -- "$backup/project/robisie.config.json" "$PWD/robisie.config.json"` |
|
|
263
|
+
| `cp -p -- "$config_home/robisie/key" "$backup/robisie/key"` | `cp -p -- "$backup/robisie/key" "$config_home/robisie/key"` |
|
|
264
|
+
| `cp -p -- "$config_home/robisie/manifest.json" "$backup/robisie/manifest.json"` | `cp -p -- "$backup/robisie/manifest.json" "$config_home/robisie/manifest.json"` |
|
|
265
|
+
| `cp -Rp -- "$config_home/robisie/backups/." "$backup/robisie/backups/"` | `cp -Rp -- "$backup/robisie/backups/." "$config_home/robisie/backups/"` |
|
|
266
|
+
| `cp -Rp -- "$config_home/robisie/roles/codex/." "$backup/robisie/roles/codex/"` | `cp -Rp -- "$backup/robisie/roles/codex/." "$config_home/robisie/roles/codex/"` |
|
|
267
|
+
| `cp -p -- "$HOME/.claude.json" "$backup/claude/claude.json"` | `cp -p -- "$backup/claude/claude.json" "$HOME/.claude.json"` |
|
|
268
|
+
| `cp -p -- "$HOME/.claude/agents/ceo-client.md" "$backup/claude/agents/ceo-client.md"` | `cp -p -- "$backup/claude/agents/ceo-client.md" "$HOME/.claude/agents/ceo-client.md"` |
|
|
269
|
+
| `cp -p -- "$HOME/.claude/agents/manager-builder-client.md" "$backup/claude/agents/manager-builder-client.md"` | `cp -p -- "$backup/claude/agents/manager-builder-client.md" "$HOME/.claude/agents/manager-builder-client.md"` |
|
|
270
|
+
| `cp -p -- "$HOME/.claude/agents/quality-officer-client.md" "$backup/claude/agents/quality-officer-client.md"` | `cp -p -- "$backup/claude/agents/quality-officer-client.md" "$HOME/.claude/agents/quality-officer-client.md"` |
|
|
271
|
+
| `cp -p -- "$codex_home/config.toml" "$backup/codex/config.toml"` | `cp -p -- "$backup/codex/config.toml" "$codex_home/config.toml"` |
|
|
272
|
+
| `cp -p -- "$codex_home/AGENTS.md" "$backup/codex/AGENTS.md"` | `cp -p -- "$backup/codex/AGENTS.md" "$codex_home/AGENTS.md"` |
|
|
273
|
+
| `cp -p -- "$config_home/opencode/opencode.json" "$backup/opencode/opencode.json"` | `cp -p -- "$backup/opencode/opencode.json" "$config_home/opencode/opencode.json"` |
|
|
274
|
+
| `cp -p -- "$config_home/opencode/agents/ceo-client.md" "$backup/opencode/agents/ceo-client.md"` | `cp -p -- "$backup/opencode/agents/ceo-client.md" "$config_home/opencode/agents/ceo-client.md"` |
|
|
275
|
+
| `cp -p -- "$config_home/opencode/agents/manager-builder-client.md" "$backup/opencode/agents/manager-builder-client.md"` | `cp -p -- "$backup/opencode/agents/manager-builder-client.md" "$config_home/opencode/agents/manager-builder-client.md"` |
|
|
276
|
+
| `cp -p -- "$config_home/opencode/agents/quality-officer-client.md" "$backup/opencode/agents/quality-officer-client.md"` | `cp -p -- "$backup/opencode/agents/quality-officer-client.md" "$config_home/opencode/agents/quality-officer-client.md"` |
|
|
277
|
+
| `cp -p -- "$config_home/opencode/plugins/robisie-review-guard.js" "$backup/opencode/plugins/robisie-review-guard.js"` | `cp -p -- "$backup/opencode/plugins/robisie-review-guard.js" "$config_home/opencode/plugins/robisie-review-guard.js"` |
|
|
278
|
+
| `cp -p -- "$profile" "$backup/profile/selected"` | `cp -p -- "$backup/profile/selected" "$profile"` |
|
|
279
|
+
| `cp -p -- "$entry_path" "$backup/entries/$entry_id"` | `cp -p -- "$backup/entries/$entry_id" "$entry_path"` |
|
|
280
|
+
|
|
281
|
+
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:
|
|
282
|
+
|
|
283
|
+
<!-- update:start -->
|
|
284
|
+
```sh
|
|
285
|
+
set +x
|
|
286
|
+
XDG_CONFIG_HOME="$config_home" &&
|
|
287
|
+
export XDG_CONFIG_HOME &&
|
|
288
|
+
{
|
|
289
|
+
if [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
|
|
290
|
+
[ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
|
|
291
|
+
[ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
|
|
292
|
+
ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key" 2>/dev/null)" &&
|
|
293
|
+
[ -n "$ROBISIE_KEY" ]; then
|
|
294
|
+
export ROBISIE_KEY
|
|
295
|
+
else
|
|
296
|
+
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
|
|
297
|
+
false
|
|
298
|
+
fi
|
|
299
|
+
} &&
|
|
300
|
+
npm i robisie@latest &&
|
|
301
|
+
npx robisie init &&
|
|
302
|
+
npx robisie doctor
|
|
303
|
+
```
|
|
304
|
+
<!-- update:end -->
|
|
305
|
+
|
|
306
|
+
Doctor sprawdza MAJOR kontraktu; exit 0 wymaga także pozostałych kontroli. Przy niezgodności wybierz zgodne wydanie, przy uszkodzonych plikach przeinstaluj paczkę. Nie ponawiaj tej samej niezgodnej instalacji.
|
|
150
307
|
|
|
151
|
-
|
|
308
|
+
### Powrót do poprzedniego wydania
|
|
309
|
+
|
|
310
|
+
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 lewą kolumnę, 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.
|
|
311
|
+
|
|
312
|
+
Po porównaniu wykonaj wybrane komendy z prawej kolumny do tych samych celów, zachowując pominięcia z absent.txt. Wiersze 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:
|
|
313
|
+
|
|
314
|
+
<!-- restore:start -->
|
|
315
|
+
```sh
|
|
316
|
+
set +x
|
|
317
|
+
XDG_CONFIG_HOME="$config_home" &&
|
|
318
|
+
export XDG_CONFIG_HOME &&
|
|
319
|
+
{
|
|
320
|
+
if [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
|
|
321
|
+
[ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
|
|
322
|
+
[ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
|
|
323
|
+
ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key" 2>/dev/null)" &&
|
|
324
|
+
[ -n "$ROBISIE_KEY" ]; then
|
|
325
|
+
export ROBISIE_KEY
|
|
326
|
+
else
|
|
327
|
+
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
|
|
328
|
+
false
|
|
329
|
+
fi
|
|
330
|
+
} &&
|
|
331
|
+
npm i --no-save "$backup/robisie-$previous_version.tgz" &&
|
|
332
|
+
npx robisie init &&
|
|
333
|
+
npx robisie doctor
|
|
334
|
+
```
|
|
335
|
+
<!-- restore:end -->
|
|
336
|
+
|
|
337
|
+
Opcja `--no-save` zachowuje przywrócone `package.json` i `package-lock.json`, bez zapisywania zależności `file:` od ścieżki prywatnej kopii.
|
|
338
|
+
|
|
339
|
+
Po każdej osobnej komendzie tabeli 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.
|
|
152
340
|
|
|
153
341
|
<!-- sekcja: odinstalowanie -->
|
|
154
342
|
## Odinstalowanie
|
|
@@ -158,11 +346,15 @@ npx robisie uninstall
|
|
|
158
346
|
npm uninstall robisie
|
|
159
347
|
```
|
|
160
348
|
|
|
161
|
-
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.
|
|
349
|
+
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.
|
|
350
|
+
|
|
351
|
+
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.
|
|
162
352
|
|
|
163
353
|
<!-- sekcja: diagnoza -->
|
|
164
354
|
## Diagnoza
|
|
165
355
|
|
|
356
|
+
Bez instalacji zacznij od konta i Connect → init; samo ponawianie doctor nie zakłada konta. Przy istniejącej instalacji doctor najpierw odczytuje ewidencję i klucz (ENV ma pierwszeństwo przed plikiem), a potem sprawdza sieć. Najpierw rozwiąż wskazany problem ewidencji/odczytu klucza, zachowując dane; błąd sieci przy istniejącej instalacji nie oznacza potrzeby nowego konta. Sprawdź połączenie i dostęp do serwera.
|
|
357
|
+
|
|
166
358
|
Komunikaty CLI pozostają po polsku. Dopasuj komunikat, a potem wykonaj wskazaną czynność:
|
|
167
359
|
|
|
168
360
|
| ID | Komunikat CLI | Następny krok |
|
|
@@ -170,16 +362,18 @@ Komunikaty CLI pozostają po polsku. Dopasuj komunikat, a potem wykonaj wskazan
|
|
|
170
362
|
| brak-klucza | `Brak klucza robisie.` | Wygeneruj klucz w Connect i przekaż go do init. |
|
|
171
363
|
| odrzucony-klucz | `Serwer robisie odrzucił klucz (nieważny albo unieważniony).` | Wygeneruj nowy klucz worker; w zsh/bash wykonaj `unset ROBISIE_KEY`, potem init z ukrytym pytaniem. |
|
|
172
364
|
| brak-odczytu | `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).` | Wybierz worker w Connect; `unset ROBISIE_KEY`, potem init z ukrytym pytaniem. |
|
|
173
|
-
| major | `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.1.
|
|
365
|
+
| major | `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.1.3 (obsługuje 1.x).` | Przykład niezgodnego MAJOR: zainstaluj wydanie zgodne z kontraktem serwera. |
|
|
174
366
|
| brak-env | `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.` | Sprawdź obsługę profilu; przy --no-shell/innej powłoce wczytaj plik klucza do środowiska sesji jak w init, potem doctor. |
|
|
175
367
|
| brak-programu | `katalog jest, programu nie ma w PATH` | Zainstaluj program wskazanego dostawcy lub dodaj go do PATH; sam katalog konfiguracji nie wystarcza. |
|
|
176
368
|
| brak-programu-i-katalogu | `brak programu w PATH i katalogu dostawcy` | Zainstaluj wybrany program, ponów init z pełną wspólną mapą i doctor. |
|
|
177
369
|
| jsonc | `nie zmieniam automatycznie` | Zachowaj JSONC; przygotuj wspierany JSON albo wybierz innego dostawcę dla wszystkich ról. Sam zdalny MCP nie wystarcza. |
|
|
178
370
|
| niepelna-instalacja | `Claude Code: niepełna instalacja` | Przykład brakującej konfiguracji: ponów init dla swojego agenta. |
|
|
179
371
|
|
|
180
|
-
Po naprawie
|
|
372
|
+
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.
|
|
181
373
|
|
|
182
374
|
<!-- sekcja: ograniczenia -->
|
|
183
375
|
## Ograniczenia
|
|
184
376
|
|
|
185
377
|
Instalator nie uruchamia sam usług w tle ani Buildera; po zgodzie operatora CEO może uruchomić Buildera przez `spawn_builder`. Pomocniki działają podczas sesji agenta, z kontekstem katalogu projektu (lub `ROBISIE_PROJECT_CONTEXT`). Instalator łączy się z robisie w celu sprawdzenia kontraktu i klucza; plik paczki nie zapewnia konta ani dostępu do dostawcy AI. Jedna wspólna tożsamość klucza nie daje trzech różnych poziomów uprawnień. Odbiór wymaga niezależnej recenzji, dowodów i zgody operatora.
|
|
378
|
+
|
|
379
|
+
Windows/WSL są niezweryfikowane. Walidacja offline sprawdza strukturę konfiguracji, nie UUID projektu, istnienie repo, dostępność modeli ani uruchomienie dostawców.
|
package/package.json
CHANGED