robisie 0.1.0 → 0.1.2

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.
Files changed (87) hide show
  1. package/CHANGELOG.md +79 -0
  2. package/README.md +109 -14
  3. package/dist/active-recovery.d.ts +58 -0
  4. package/dist/active-recovery.js +143 -0
  5. package/dist/agents.d.ts +34 -0
  6. package/dist/agents.js +77 -16
  7. package/dist/attempt-identity.d.ts +21 -0
  8. package/dist/attempt-identity.js +39 -0
  9. package/dist/ci-failure-result.d.ts +23 -0
  10. package/dist/ci-failure-result.js +90 -0
  11. package/dist/claude-headless.d.ts +7 -0
  12. package/dist/claude-headless.js +28 -0
  13. package/dist/cli.d.ts +17 -0
  14. package/dist/cli.js +54 -14
  15. package/dist/commands.d.ts +18 -0
  16. package/dist/commands.js +195 -88
  17. package/dist/constants.d.ts +32 -0
  18. package/dist/constants.js +3 -3
  19. package/dist/context.d.ts +24 -0
  20. package/dist/context.js +22 -6
  21. package/dist/dependency-readiness.d.ts +13 -0
  22. package/dist/dependency-readiness.js +80 -0
  23. package/dist/dispatch-scope.d.ts +18 -0
  24. package/dist/dispatch-scope.js +46 -0
  25. package/dist/done-evidence.d.ts +31 -0
  26. package/dist/done-evidence.js +216 -0
  27. package/dist/engine-config.d.ts +65 -0
  28. package/dist/engine-config.js +139 -0
  29. package/dist/fsops.d.ts +87 -0
  30. package/dist/fsops.js +117 -24
  31. package/dist/helpers.d.ts +15 -0
  32. package/dist/helpers.js +268 -45
  33. package/dist/intent-rules/admission.d.ts +10 -0
  34. package/dist/intent-rules/admission.js +35 -0
  35. package/dist/intent-rules/done-when-roles.d.ts +21 -0
  36. package/dist/intent-rules/done-when-roles.js +101 -0
  37. package/dist/intent-rules/hooks.d.ts +29 -0
  38. package/dist/intent-rules/hooks.js +23 -0
  39. package/dist/k3-codex-role.d.ts +20 -0
  40. package/dist/k3-codex-role.js +68 -0
  41. package/dist/manifest.d.ts +41 -0
  42. package/dist/manifest.js +59 -14
  43. package/dist/mcp.d.ts +18 -0
  44. package/dist/mcp.js +117 -40
  45. package/dist/opencode-result.d.ts +19 -0
  46. package/dist/opencode-result.js +136 -0
  47. package/dist/opencode-review-guard.d.ts +1 -0
  48. package/dist/opencode-review-guard.js +19 -0
  49. package/dist/opencode-session-export.d.ts +5 -0
  50. package/dist/opencode-session-export.js +28 -0
  51. package/dist/outcome-moves.d.ts +15 -0
  52. package/dist/outcome-moves.js +39 -0
  53. package/dist/planer-client.d.ts +214 -0
  54. package/dist/planer-client.js +351 -0
  55. package/dist/restart-recovery.d.ts +47 -0
  56. package/dist/restart-recovery.js +70 -0
  57. package/dist/review-source-packet.d.ts +17 -0
  58. package/dist/review-source-packet.js +44 -0
  59. package/dist/role-registry.d.ts +25 -0
  60. package/dist/role-registry.js +91 -0
  61. package/dist/role-results.d.ts +15 -0
  62. package/dist/role-results.js +42 -0
  63. package/dist/roles.d.ts +30 -0
  64. package/dist/roles.js +20 -16
  65. package/dist/seed-validation.d.ts +28 -0
  66. package/dist/seed-validation.js +294 -0
  67. package/dist/selection-result.d.ts +44 -0
  68. package/dist/selection-result.js +144 -0
  69. package/dist/sparse-policy.d.ts +8 -0
  70. package/dist/sparse-policy.js +49 -0
  71. package/dist/tester-identity.d.ts +11 -0
  72. package/dist/tester-identity.js +53 -0
  73. package/dist/worker-env.d.ts +5 -0
  74. package/dist/worker-env.js +34 -0
  75. package/docs/ENGINE-API.md +88 -0
  76. package/docs/ENGINE-CONFIG.md +113 -0
  77. package/docs/README.en.md +142 -20
  78. package/docs/README.md +144 -20
  79. package/docs/RELEASE-0.1.0.md +81 -8
  80. package/docs/RELEASE-0.1.1.md +110 -0
  81. package/helpers/ceo-client-launcher-mcp.mjs +36 -8
  82. package/helpers/client-spawn-session.sh +181 -0
  83. package/helpers/client-spawn.sh +825 -0
  84. package/package.json +9 -4
  85. package/roles/ceo-client.md +3 -2
  86. package/roles/manager-builder-client.md +18 -4
  87. package/roles/quality-officer-client.md +20 -6
package/docs/README.md CHANGED
@@ -1,19 +1,23 @@
1
- # robisie — od konta do odebranej karty (paczka 0.1.0)
1
+ # robisie — od konta do odebranej karty (paczka 0.1.2)
2
2
 
3
3
  English: [README.en.md](README.en.md).
4
4
 
5
+ [API silnika](ENGINE-API.md).
6
+
5
7
  <!-- sekcja: dostepnosc -->
6
8
  ## Dostępność
7
9
 
8
- Ten przewodnik dotyczy otrzymanego pliku `robisie-0.1.0.tgz`, bez pobierania instalatora z rejestru npm. Wynik 404 z 20.10.2026 jest obserwacją historyczną. Zespół przekazuje tgz; wszystkie dalsze polecenia i sesje agentów uruchamiaj w katalogu, w którym zainstalujesz tę paczkę. [Przygotowanie](#wymagania) → [konto](#konto) → [klucz](#klucz) → [instalacja](#instalacja) → [odbiór](#recenzja-i-odbior).
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.
11
+
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).
9
13
 
10
14
  <!-- sekcja: wymagania -->
11
15
  <a id="wymagania"></a>
12
16
  ## Wymagania
13
17
 
14
- 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. Na Windows używaj WSL (ścieżki POSIX).
18
+ 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.
15
19
 
16
- Przygotuj pusty katalog na dysku i umieść w nim tylko otrzymany tgz oraz README. Nie potrzebujesz strony ani pliku `package.json`; instalacja npm utworzy pliki zależności. To katalog pracy agentów, niezależny od projektu w panelu.
20
+ 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.
17
21
 
18
22
  <!-- sekcja: konto -->
19
23
  <a id="konto"></a>
@@ -35,16 +39,34 @@ Paczka zapisuje **jeden klucz dla CEO, Buildera i Quality Officera** jako `ROBIS
35
39
 
36
40
  <!-- sekcja: instalacja -->
37
41
  <a id="instalacja"></a>
38
- ## Instalacja pliku paczki
42
+ ## Instalacja z npm
39
43
 
40
- Człowiek otwiera terminal w przygotowanym katalogu z tgz i README:
44
+ 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:
41
45
 
42
46
  ```sh
43
- npm i ./robisie-0.1.0.tgz
44
- npx robisie version
47
+ cd "/ścieżka/do/pustego katalogu" &&
48
+ node -e 'try {
49
+ require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
50
+ } catch (error) {
51
+ console.error(error.message);
52
+ process.exit(1);
53
+ }' &&
54
+ {
55
+ npm i robisie &&
56
+ unset ROBISIE_KEY &&
57
+ npx robisie init --agent claude &&
58
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
59
+ ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key")" &&
60
+ export ROBISIE_KEY &&
61
+ npx robisie doctor
62
+ }
45
63
  ```
46
64
 
47
- Oczekiwany wynik: 0.1.0. Jeśli npm nie znajduje pliku, sprawdź katalog i nazwę otrzymanego tgz. Pomocniki `client-launch-context` i `ceo-client-launcher` agent uruchamia przez `npx -y robisie@0.1.0 mcp <nazwa>`; lokalna paczka musi być dostępna z cwd sesji.
65
+ Ł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
+
67
+ W istniejącym projekcie zachowaj manifest i użyj instrukcji aktualizacji.
68
+
69
+ 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.
48
70
 
49
71
  <!-- sekcja: init -->
50
72
  ## Połączenie agenta
@@ -70,7 +92,9 @@ npx robisie init --agent opencode --role ceo=opencode --role builder=opencode --
70
92
  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:
71
93
 
72
94
  ```sh
73
- [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] && export ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key")"
95
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
96
+ ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key")" &&
97
+ export ROBISIE_KEY
74
98
  ```
75
99
 
76
100
  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.
@@ -108,11 +132,15 @@ Doctor uruchamia plik pomocnika przez node, agent przez npx. `ROBISIE_PROJECT_CO
108
132
  <!-- sekcja: pierwsza-karta -->
109
133
  ## Pierwsza karta i start Buildera
110
134
 
111
- 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 discovery przekaż prośbę, która działa przy samym README i tgz:
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 discovery przekaż prośbę, która działa po instalacji npm z samym README:
112
136
 
113
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. Przygotuj zakres i zaczekaj na moją zgodę; po pracy potrzebuję niezależnej recenzji i mojego odbioru.
114
138
 
115
- Zgoda człowieka poprzedza Buildera: `draft` → `ready` → `in_progress` → `in_review` → niezależna recenzja i verified receipt → `delivered` → odbiór właściciela → `done`. CEO podaje polecenie, **człowiek uruchamia Buildera w nowym terminalu w katalogu instalacji**; automatyczny launcher zwykłego katalogu może pozostawić kartę ready.
139
+ 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
+
141
+ Przy błędzie `spawn_builder` CEO zgłasza błąd i naprawia przyczynę przed ponowieniem; nie przełącza automatycznie na ręczny start.
142
+
143
+ Ręczny start to wyłącznie jawny wybór operatora: wtedy CEO podaje polecenie do uruchomienia w nowym terminalu w katalogu instalacji.
116
144
 
117
145
  ID pochodzi z utworzonej lub odczytanej karty, nie z projektu ani sesji. Poniżej fikcyjny przykład małego kanonicznego UUID; zastąp go dokładnym ID karty. Przykład Codex zakłada XDG_CONFIG_HOME=/home/tester/Robisie config: zastąp całą ścieżkę rzeczywistą z instalacji (domyślnie $HOME/.config/robisie/roles/codex/manager-builder-client.md). Tylda wewnątrz cytowanego promptu nie rozwinie się. Wybierz jedno polecenie:
118
146
 
@@ -128,16 +156,108 @@ Oczekiwany wynik startu: świeży odczyt CEO potwierdza przydzieloną kartę in_
128
156
  <a id="recenzja-i-odbior"></a>
129
157
  ## Recenzja i jawny odbiór
130
158
 
131
- CEO uruchamia niezależnego Quality Officera przez `Agent(quality-officer-client)`, po świeżym odczycie in_review. Quality Officer niezależnie sprawdza wynik i zapisuje recenzję oraz dowody na karcie; Builder nie recenzuje własnej pracy. Sprawdzenie dowodów i jawna zgoda na odbiór to obowiązek operatora. Po zweryfikowanej recenzji i przejściu do delivered sprawdź kryteria odbioru; jeśli do odbioru brakuje dowodów lub Twojej zgody, pozostaw kartę w `delivered`.
159
+ W Claude Code CEO uruchamia niezależnego Quality Officera przez `Agent(quality-officer-client)`, po świeżym odczycie in_review. Quality Officer niezależnie sprawdza wynik i zapisuje recenzję oraz dowody na karcie; Builder nie recenzuje własnej pracy. CEO weryfikuje potwierdzenie recenzji (verified receipt) i wykonuje świeże odczyty karty wymagane przez protokół przed przejściem do `delivered`; następnie jawny odbiór operatora pozwala przejść do `done`. Sprawdzenie dowodów i jawna zgoda na odbiór to obowiązek operatora. Po zweryfikowanej recenzji i przejściu do delivered sprawdź kryteria odbioru; jeśli do odbioru brakuje dowodów lub Twojej zgody, pozostaw kartę w `delivered`.
132
160
 
133
- Przejście do delivered wymaga niezależnej recenzji oraz zweryfikowanego potwierdzenia (verified receipt). Jeśli w sesji CEO brakuje narzędzia Agent, w szczególności w Codex/OpenCode, karta pozostaje w `in_review`: to brak zdolności produktu wymagający naprawy CEO/CR. Nie zastępuj recenzji oceną Buildera ani ręczną zmianą etapu. Sama konfiguracja trzech ról nie zapewnia tej integracji.
161
+ 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
+
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/CR. Nie zastępuj recenzji oceną Buildera ani ręczną zmianą etapu. Sama konfiguracja trzech ról nie zapewnia tej integracji.
134
164
 
135
165
  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.
136
166
 
137
167
  <!-- sekcja: aktualizacja -->
138
- ## Aktualizacja
168
+ ## Aktualizacja i prywatna kopia
169
+
170
+ 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.
139
171
 
140
- Człowiek uzyskuje od zespołu plik tgz zgodny z MAJOR kontraktu serwera. W tym samym katalogu instaluje otrzymany plik przez `npm i ./robisie-0.1.0.tgz` (zastąp nazwę nazwą zgodnego wydania), potem `npx robisie init` i `npx robisie doctor`. Oczekiwany wynik: zgodna wersja, pełna konfiguracja i exit 0 doctor; przy niezgodności uzyskaj właściwe wydanie zamiast ponawiać tę samą instalację. Przy uszkodzonych plikach przeinstaluj otrzymany tgz tą samą komendą. Nie potrzebujesz wydania z rejestru npm.
172
+ ```sh
173
+ set +x
174
+ umask 077 &&
175
+ config_home="${XDG_CONFIG_HOME:-$HOME/.config}" &&
176
+ codex_home="${CODEX_HOME:-$HOME/.codex}" &&
177
+ backup="$(mktemp -d "$HOME/robisie-backup.XXXXXX")" &&
178
+ mkdir -p "$backup/project" "$backup/robisie/backups" "$backup/robisie/roles/codex" \
179
+ "$backup/claude/agents" "$backup/codex" "$backup/opencode/agents" \
180
+ "$backup/opencode/plugins" "$backup/profile" "$backup/entries" &&
181
+ previous_version='0.1.1' &&
182
+ npm pack "robisie@$previous_version" --pack-destination "$backup"
183
+ ```
184
+
185
+ 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.
186
+
187
+ 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
+
189
+ 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.
190
+
191
+ `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.
192
+
193
+ | Źródło → prywatna kopia (przed aktualizacją) | Kopia → cel restore (dopiero po porównaniu) |
194
+ |---|---|
195
+ | `cp -p -- "$PWD/package.json" "$backup/project/package.json"` | `cp -p -- "$backup/project/package.json" "$PWD/package.json"` |
196
+ | `cp -p -- "$PWD/package-lock.json" "$backup/project/package-lock.json"` | `cp -p -- "$backup/project/package-lock.json" "$PWD/package-lock.json"` |
197
+ | `cp -p -- "$PWD/robisie.config.json" "$backup/project/robisie.config.json"` | `cp -p -- "$backup/project/robisie.config.json" "$PWD/robisie.config.json"` |
198
+ | `cp -p -- "$config_home/robisie/key" "$backup/robisie/key"` | `cp -p -- "$backup/robisie/key" "$config_home/robisie/key"` |
199
+ | `cp -p -- "$config_home/robisie/manifest.json" "$backup/robisie/manifest.json"` | `cp -p -- "$backup/robisie/manifest.json" "$config_home/robisie/manifest.json"` |
200
+ | `cp -Rp -- "$config_home/robisie/backups/." "$backup/robisie/backups/"` | `cp -Rp -- "$backup/robisie/backups/." "$config_home/robisie/backups/"` |
201
+ | `cp -Rp -- "$config_home/robisie/roles/codex/." "$backup/robisie/roles/codex/"` | `cp -Rp -- "$backup/robisie/roles/codex/." "$config_home/robisie/roles/codex/"` |
202
+ | `cp -p -- "$HOME/.claude.json" "$backup/claude/claude.json"` | `cp -p -- "$backup/claude/claude.json" "$HOME/.claude.json"` |
203
+ | `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"` |
204
+ | `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"` |
205
+ | `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"` |
206
+ | `cp -p -- "$codex_home/config.toml" "$backup/codex/config.toml"` | `cp -p -- "$backup/codex/config.toml" "$codex_home/config.toml"` |
207
+ | `cp -p -- "$codex_home/AGENTS.md" "$backup/codex/AGENTS.md"` | `cp -p -- "$backup/codex/AGENTS.md" "$codex_home/AGENTS.md"` |
208
+ | `cp -p -- "$config_home/opencode/opencode.json" "$backup/opencode/opencode.json"` | `cp -p -- "$backup/opencode/opencode.json" "$config_home/opencode/opencode.json"` |
209
+ | `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"` |
210
+ | `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"` |
211
+ | `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"` |
212
+ | `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"` |
213
+ | `cp -p -- "$profile" "$backup/profile/selected"` | `cp -p -- "$backup/profile/selected" "$profile"` |
214
+ | `cp -p -- "$entry_path" "$backup/entries/$entry_id"` | `cp -p -- "$backup/entries/$entry_id" "$entry_path"` |
215
+
216
+ 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
+
218
+ <!-- update:start -->
219
+ ```sh
220
+ set +x
221
+ XDG_CONFIG_HOME="$config_home" &&
222
+ export XDG_CONFIG_HOME &&
223
+ [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
224
+ [ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
225
+ [ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
226
+ ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key")" &&
227
+ export ROBISIE_KEY &&
228
+ npm i robisie@latest &&
229
+ npx robisie init &&
230
+ npx robisie doctor
231
+ ```
232
+ <!-- update:end -->
233
+
234
+ 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.
235
+
236
+ ### Powrót do poprzedniego wydania
237
+
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 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.
239
+
240
+ 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. Potem w tym samym cwd zainstaluj zachowany zgodny tgz, wczytaj przywrócony stary klucz do ENV i dopiero wykonaj init oraz doctor:
241
+
242
+ <!-- restore:start -->
243
+ ```sh
244
+ set +x
245
+ npm i --no-save "$backup/robisie-$previous_version.tgz" &&
246
+ XDG_CONFIG_HOME="$config_home" &&
247
+ export XDG_CONFIG_HOME &&
248
+ [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
249
+ [ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
250
+ [ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
251
+ ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key")" &&
252
+ export ROBISIE_KEY &&
253
+ npx robisie init &&
254
+ npx robisie doctor
255
+ ```
256
+ <!-- restore:end -->
257
+
258
+ Opcja `--no-save` zachowuje przywrócone `package.json` i `package-lock.json`, bez zapisywania zależności `file:` od ścieżki prywatnej kopii.
259
+
260
+ 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.
141
261
 
142
262
  <!-- sekcja: odinstalowanie -->
143
263
  ## Odinstalowanie
@@ -147,11 +267,13 @@ npx robisie uninstall
147
267
  npm uninstall robisie
148
268
  ```
149
269
 
150
- 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.
270
+ 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.
151
271
 
152
272
  <!-- sekcja: diagnoza -->
153
273
  ## Diagnoza
154
274
 
275
+ 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.
276
+
155
277
  Komunikaty CLI pozostają po polsku. Dopasuj komunikat, a potem wykonaj wskazaną czynność:
156
278
 
157
279
  | ID | Komunikat CLI | Następny krok |
@@ -159,16 +281,18 @@ Komunikaty CLI pozostają po polsku. Dopasuj komunikat, a potem wykonaj wskazan
159
281
  | brak-klucza | `Brak klucza robisie.` | Wygeneruj klucz w Connect i przekaż go do init. |
160
282
  | 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. |
161
283
  | 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. |
162
- | major | `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.1.0 (obsługuje 1.x).` | Przykład niezgodnego MAJOR: uzyskaj zgodny plik paczki od zespołu. |
284
+ | major | `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.1.2 (obsługuje 1.x).` | Przykład niezgodnego MAJOR: zainstaluj wydanie zgodne z kontraktem serwera. |
163
285
  | 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. |
164
286
  | brak-programu | `katalog jest, programu nie ma w PATH` | Zainstaluj program wskazanego dostawcy lub dodaj go do PATH; sam katalog konfiguracji nie wystarcza. |
165
287
  | 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. |
166
288
  | jsonc | `nie zmieniam automatycznie` | Zachowaj JSONC; przygotuj wspierany JSON albo wybierz innego dostawcę dla wszystkich ról. Sam zdalny MCP nie wystarcza. |
167
289
  | niepelna-instalacja | `Claude Code: niepełna instalacja` | Przykład brakującej konfiguracji: ponów init dla swojego agenta. |
168
290
 
169
- Po naprawie uruchom lokalne `npx robisie init` i `npx robisie doctor`; przy braku plików najpierw przeinstaluj otrzymany tgz, przy MAJOR uzyskaj zgodne wydanie. 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.
291
+ 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.
170
292
 
171
293
  <!-- sekcja: ograniczenia -->
172
294
  ## Ograniczenia
173
295
 
174
- Paczka nie uruchamia usług w tle ani Buildera automatycznie. 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.
296
+ 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.
297
+
298
+ Windows/WSL są niezweryfikowane. Walidacja offline sprawdza strukturę konfiguracji, nie UUID projektu, istnienie repo, dostępność modeli ani uruchomienie dostawców.
@@ -4,13 +4,17 @@
4
4
 
5
5
  Klient łączy Claude Code, Codex CLI lub OpenCode z tablicą robisie. `init` instaluje konfigurację MCP, role CEO, Builder i Quality Officer oraz polecenia pomocników `client-launch-context` i `ceo-client-launcher`; `doctor` sprawdza połączenie i instalację, a `uninstall` usuwa zarejestrowane zmiany. Obce ustawienia i instrukcje pozostają; pierwsze kopie zapasowe zachowują stan sprzed instalacji.
6
6
 
7
- Wymagania: Node.js >=20, npm i własny zainstalowany agent z dostępem do dostawcy AI; połączenie z robisie i klucz z Connect. Windows wymaga WSL (ścieżki POSIX). Klient rozumie kontrakt serwera 1.x, obecnie 1.0.0. Inny major, np. 2.0.0, jest odrzucany przed zapisem przez `init`; starszy klient nie obniża kontraktu serwera.
7
+ Wymagania 0.1: macOS lub Linux, Node.js >=20, npm i własny zainstalowany agent z dostępem do dostawcy AI; połączenie z robisie i klucz z Connect. Windows/WSL nie mają zweryfikowanego wsparcia. Klient rozumie kontrakt serwera 1.x, obecnie 1.0.0. Inny major, np. 2.0.0, jest odrzucany przed zapisem przez `init`; starszy klient nie obniża kontraktu serwera.
8
8
 
9
- Dostępność: raportowany wynik `npm view robisie` z 20.10.2026 to E404 — nie można pobrać `robisie` z npm. Nie wykonano tu nowego pomiaru. Bez lokalnie zainstalowanej paczki `npx robisie` i pomocniki nie wystartują. Otrzymany plik `robisie-0.1.0.tgz` można zainstalować przez `npm i ./robisie-0.1.0.tgz` w projekcie; uruchamiaj agenta w tym samym katalogu, aby `npx -y robisie@0.1.0 mcp <nazwa>` znalazło lokalną paczkę. Szczegóły: [README](README.md).
9
+ Dostępność: instalacja z npm przez `npm i robisie` w katalogu pracy agenta; dalsze kroki opisuje [README](README.md).
10
10
 
11
- Ograniczenia: wszystkie trzy role muszą obecnie używać jednego dostawcy; mieszana mapa daje błąd `doctor`. Operator uruchamia Buildera w nowym terminalu i jawnie odbiera wynik po niezależnej recenzji. Instalacja nie dowodzi przejścia całej pętli klienta ani uruchomienia pracy autonomicznej.
11
+ Po zgodzie człowieka na kartę potwierdzoną w `ready` CEO domyślnie uruchamia Buildera przez `ceo-client-launcher` → `spawn_builder`. Ręczny start w nowym terminalu jest wyłącznie jawnym wyborem operatora; błąd pomocnika wymaga zgłoszenia i naprawy przyczyny przed ponowieniem, bez automatycznego przejścia na ręczny start. Instalator sam nie startuje usług w tle ani Buildera.
12
12
 
13
- Powrót lokalny: zachowaj poprzedni tgz i kopię własnej konfiguracji; w tym samym projekcie zainstaluj go przez `npm i ./robisie-0.1.0.tgz`, potem `npx robisie init --agent <agent>` i `npx robisie doctor`. Najpierw sprawdź zgodność kontraktu. Test 0.1.0 → syntetyczne 0.1.1 → 0.1.0 jest lokalną próbą reinstalacji i powrotu, nie rollbackiem opublikowanych wydań. `npx robisie uninstall` przywraca niezmienione role sprzed instalacji, zachowuje backupy, a role zmienione przez użytkownika pozostawia z ostrzeżeniem. Backupy mogą zawierać klucz — chroń je.
13
+ Ograniczenia: wszystkie trzy role muszą obecnie używać jednego dostawcy; mieszana mapa daje błąd `doctor`. Sam `doctor` nie potwierdza dostępności narzędzi obu pomocników w sesji dostawcy — sprawdź je zgodnie z README. W Claude Code niezależny Quality Officer przez `Agent(quality-officer-client)`, dowody i verified receipt poprzedzają `delivered`, a jawny odbiór operatora poprzedza `done`. OpenCode pozostaje w `in_review` niezależnie od dostępności Agent, bez wspieranego przejścia do `delivered`; pełny odbiór wymaga ścieżki Claude Code. Codex wymaga integracji Agent, niezależnej recenzji i verified receipt; brak Agent pozostawia kartę w `in_review` do naprawy CEO/CR. Builder nie recenzuje własnej pracy.
14
+
15
+ Biblioteki ESM w `dist/` obejmują parser konfiguracji `engine-config`, wyniki ról `role-results`, SDK tablicy `planer-client` ([API silnika](ENGINE-API.md)), rejestr ról, walidację zasiewu i reguły intencji, wybór i zakres pracy, ruchy i odzyskiwanie stanu, tożsamość prób/testera, środowisko Workera, źródła recenzji, wyniki CI oraz adaptery Claude/Codex/OpenCode i eksport sesji. `robisie.config.json` opisuje instancję: projekt, tory, katalog stanu i role; sekcja `engine` opisuje repo, gałąź, komendy, wymagane kontrole i sposób dostarczenia. Parser konfiguracji niczego nie uruchamia. Instalacja, import bibliotek i obecność pomocników nie dowodzą uruchomienia silnika ani pełnej autonomicznej pętli klienta.
16
+
17
+ Powrót lokalny: zachowaj poprzedni tgz i kopię własnej konfiguracji; w tym samym projekcie zainstaluj go przez `npm i ./robisie-0.1.0.tgz`, potem `npx robisie init --agent <agent>` i `npx robisie doctor`. Najpierw sprawdź zgodność kontraktu. Test 0.1.0 → syntetyczne 0.1.1 → 0.1.0 jest lokalną próbą reinstalacji i powrotu, nie rollbackiem opublikowanych wydań. `npx robisie uninstall` usuwa zarejestrowane wpisy/bloki robisie, nie przywraca starych wpisów robisie; cofa niezmienione role, a zmienione przez użytkownika pozostawia z ostrzeżeniem. Backupy pozostają i mogą zawierać klucz — chroń je. Bez zapisu instalacji komenda nie usuwa pliku klucza; odmowa sprawdzenia konfiguracji Codex następuje przed usunięciem klucza, a po tym sprawdzeniu klucz jest usuwany nawet przy późniejszym błędzie. Kod różny od zera wymaga rozwiązania wskazanego problemu. Uninstall nie unieważnia klucza na serwerze (zrób to osobno w Connect); `npm uninstall robisie` usuwa paczkę z projektu, zgodnie z README.
14
18
 
15
19
  Ten dokument nie potwierdza tagu, GitHub Release ani publikacji npm.
16
20
 
@@ -18,12 +22,81 @@ Ten dokument nie potwierdza tagu, GitHub Release ani publikacji npm.
18
22
 
19
23
  The client connects Claude Code, Codex CLI or OpenCode to the robisie board. `init` installs MCP configuration, CEO, Builder and Quality Officer roles and the `client-launch-context` and `ceo-client-launcher` helper commands. `doctor` checks the connection and installation; `uninstall` removes recorded changes. Other settings and instructions survive; first backups retain the state before installation.
20
24
 
21
- Requirements: Node.js >=20, npm, an installed agent with your own AI provider access, a robisie connection and a Connect key. Windows requires WSL (POSIX paths). The client supports server contract 1.x, currently 1.0.0. `init` refuses another major, such as 2.0.0, before writing; an older client cannot downgrade the server contract.
25
+ Requirements for 0.1: macOS or Linux, Node.js >=20, npm, an installed agent with your own AI provider access, a robisie connection and a Connect key. Windows/WSL support is unverified. The client supports server contract 1.x, currently 1.0.0. `init` refuses another major, such as 2.0.0, before writing; an older client cannot downgrade the server contract.
26
+
27
+ Availability: install from npm with `npm i robisie` in the agent working directory; follow [README](README.en.md) for the next steps.
22
28
 
23
- Availability: the reported `npm view robisie` result on 20 October 2026 was E404: `robisie` cannot be downloaded from npm. No fresh registry check was performed here. Without a locally installed package, `npx robisie` and the helpers cannot start. Install a supplied `robisie-0.1.0.tgz` with `npm i ./robisie-0.1.0.tgz` in the project and run the agent from that directory so `npx -y robisie@0.1.0 mcp <name>` can resolve the local package. See [README](README.md).
29
+ After human approval of a card confirmed in `ready`, the CEO starts the Builder by default through `ceo-client-launcher` → `spawn_builder`. Manual startup in a new terminal is only the operator's explicit choice; a helper error must be reported and its cause resolved before retrying, without automatically switching to manual startup. The installer itself starts neither background services nor the Builder.
24
30
 
25
- Limitations: all three roles currently need the same provider; `doctor` rejects mixed assignments. The operator starts the Builder in a new terminal and explicitly accepts the result after independent review. Installation does not prove the complete customer loop or autonomous execution.
31
+ Limitations: all three roles currently need the same provider; `doctor` rejects mixed assignments. `doctor` alone does not confirm that both helpers' tools are available in the provider session — check them as described in README. In Claude Code, an independent Quality Officer through `Agent(quality-officer-client)`, evidence and a verified receipt precede `delivered`; explicit operator acceptance precedes `done`. OpenCode stays in `in_review` regardless of Agent availability, with no supported transition to `delivered`; full acceptance requires the Claude Code path. Codex requires Agent integration, independent review and a verified receipt; without Agent, the card stays in `in_review` pending CEO/CR repair. The Builder does not review its own work.
26
32
 
27
- Local return: retain the previous tgz and a copy of your configuration. Install it in the same project with `npm i ./robisie-0.1.0.tgz`, then run `npx robisie init --agent <agent>` and `npx robisie doctor`, checking contract compatibility first. The 0.1.0 → synthetic 0.1.1 → 0.1.0 test is a local reinstall and return rehearsal, not a rollback of published releases. `npx robisie uninstall` restores unchanged role files from before installation, keeps backups and leaves user-edited roles with a warning. Backups may contain a key; protect them.
33
+ The ESM libraries in `dist/` include the `engine-config` configuration parser, `role-results` role outcomes, the `planer-client` board SDK ([engine API](ENGINE-API.md)), role registry, seed validation and intent rules, selection and dispatch scope, outcome moves and recovery, attempt/tester identity, Worker environment, review source packets, CI results, Claude/Codex/OpenCode adapters and session export. `robisie.config.json` describes an instance: project, tracks, state directory and roles; its `engine` section describes the repository, branch, commands, required checks and delivery mode. Parsing configuration starts nothing. Installation, library imports and shipped helpers do not prove a running engine or a complete autonomous customer loop.
34
+
35
+ Local return: retain the previous tgz and a copy of your configuration. Install it in the same project with `npm i ./robisie-0.1.0.tgz`, then run `npx robisie init --agent <agent>` and `npx robisie doctor`, checking contract compatibility first. The 0.1.0 → synthetic 0.1.1 → 0.1.0 test is a local reinstall and return rehearsal, not a rollback of published releases. `npx robisie uninstall` removes recorded robisie entries/blocks without restoring old robisie entries; it restores unchanged role files and leaves user-edited roles with a warning. Backups remain and may contain a key; protect them. Without an installation record, the key file is not removed; Codex configuration refusal happens before key deletion, while after that check the key is removed even if a later step fails. A nonzero exit requires resolving the reported problem. Uninstall does not revoke the server key (revoke it separately in Connect); `npm uninstall robisie` removes the project package, as described in README.
28
36
 
29
37
  This document does not confirm a tag, GitHub Release or npm publication.
38
+
39
+ ## Wspólny przykład PL/EN / Shared PL/EN example
40
+
41
+ Przykład zwraca konfigurację instancji bez uruchamiania silnika; `./state` jest liczone względem pliku konfiguracji. / The example returns instance configuration without starting the engine; `./state` is resolved relative to the configuration file.
42
+
43
+ <!-- release-surface:example:start -->
44
+ ```js
45
+ import { parseConfig } from 'robisie/dist/engine-config.js';
46
+
47
+ export const config = parseConfig({
48
+ project: 'example-project',
49
+ tracks: [{ id: 'example-track', name: 'Praca' }],
50
+ stateDir: './state',
51
+ }, '/example/robisie.config.json');
52
+ ```
53
+ <!-- release-surface:example:end -->
54
+
55
+ ## Zawartość paczki / Package inventory
56
+
57
+ Ścieżki bibliotek/CLI i pomocników; wpis przy launcherze wskazuje zarejestrowane narzędzie. Deklaracje `.d.ts` mogą towarzyszyć modułom JS. / Library/CLI and helper paths; the launcher entry names its registered tool. Type declarations may accompany JS modules.
58
+
59
+ <!-- release-surface:inventory:start -->
60
+ - `dist/active-recovery.js`
61
+ - `dist/agents.js`
62
+ - `dist/attempt-identity.js`
63
+ - `dist/ci-failure-result.js`
64
+ - `dist/claude-headless.js`
65
+ - `dist/cli.js`
66
+ - `dist/commands.js`
67
+ - `dist/constants.js`
68
+ - `dist/context.js`
69
+ - `dist/dependency-readiness.js`
70
+ - `dist/dispatch-scope.js`
71
+ - `dist/done-evidence.js`
72
+ - `dist/engine-config.js`
73
+ - `dist/fsops.js`
74
+ - `dist/helpers.js`
75
+ - `dist/intent-rules/admission.js`
76
+ - `dist/intent-rules/done-when-roles.js`
77
+ - `dist/intent-rules/hooks.js`
78
+ - `dist/k3-codex-role.js`
79
+ - `dist/manifest.js`
80
+ - `dist/mcp.js`
81
+ - `dist/opencode-result.js`
82
+ - `dist/opencode-review-guard.js`
83
+ - `dist/opencode-session-export.js`
84
+ - `dist/outcome-moves.js`
85
+ - `dist/planer-client.js`
86
+ - `dist/restart-recovery.js`
87
+ - `dist/review-source-packet.js`
88
+ - `dist/role-registry.js`
89
+ - `dist/role-results.js`
90
+ - `dist/roles.js`
91
+ - `dist/seed-validation.js`
92
+ - `dist/selection-result.js`
93
+ - `dist/sparse-policy.js`
94
+ - `dist/tester-identity.js`
95
+ - `dist/worker-env.js`
96
+ - `helpers/ceo-client-launcher-mcp.mjs` → `spawn_builder`
97
+ - `helpers/client-launch-context-mcp.mjs`
98
+ - `helpers/client-spawn-session.sh`
99
+ - `helpers/client-spawn.sh`
100
+ - `helpers/lib/client-review-receipt.mjs`
101
+ - `helpers/lib/client-spawn-failure.mjs`
102
+ <!-- release-surface:inventory:end -->
@@ -0,0 +1,110 @@
1
+ # robisie 0.1.1 — wydanie utrzymaniowe / maintenance release
2
+
3
+ ## Polski
4
+
5
+ 0.1.1 zbiera poprawki instalacji, uprawnień prywatnych plików, kopii zapasowych, odmowy przekierowania MCP z poświadczeniem, bezpiecznej diagnostyki i odzyskiwania oraz bibliotek API klienta. [CHANGELOG](https://github.com/chuppa12/robisie-app/blob/main/packages/client/CHANGELOG.md) wymienia dokładnie 45 kart z lokalnym odbiorem TAK (E3: 26, E4: 4, E5: 3, E6: 12). Lokalny odbiór nie potwierdza publikacji ani działania wersji pobranej z npm.
6
+
7
+ Ograniczenia odbioru 0.1.1: `805aad70` — krok 5 z rolami i pomocnikami w prawdziwej sesji Claude Code nie został sprawdzony; pomocniki sprawdzono bezpośrednio przez `robisie mcp`. `80931e36` — profil Bash sprawdzono z symulacją macOS na Linuksie; rzeczywisty przebieg na Macu pozostaje otwarty. Dla `9d10bca2` i `13bafb12` lokalny odbiór dotyczy konsumenta paczki; integracja z usługą klienta to osobny odbiór. Odmowa `init` może pozostawić częściową instalację (`1bd3a86d`); rozwiąż zgłoszony problem i sprawdź stan, zanim ponowisz. Żadna z tych granic nie znika po instalacji.
8
+
9
+ Klient łączy Claude Code, Codex CLI lub OpenCode z tablicą robisie. `init` instaluje konfigurację MCP, role CEO, Builder i Quality Officer oraz polecenia pomocników `client-launch-context` i `ceo-client-launcher`; `doctor` sprawdza połączenie i instalację, a `uninstall` usuwa zarejestrowane zmiany. Obce ustawienia i instrukcje pozostają; pierwsze kopie zapasowe zachowują stan sprzed instalacji.
10
+
11
+ Wymagania 0.1: macOS lub Linux, Node.js >=20, npm i własny zainstalowany agent z dostępem do dostawcy AI; połączenie z robisie i klucz z Connect. Windows/WSL nie mają zweryfikowanego wsparcia. Klient rozumie kontrakt serwera 1.x, obecnie 1.0.0. Inny major, np. 2.0.0, jest odrzucany przed zapisem przez `init`; starszy klient nie obniża kontraktu serwera.
12
+
13
+ Instalacja kandydata: `npm i ./robisie-0.1.1.tgz`; po potwierdzonej publikacji: `npm i robisie@0.1.1` w katalogu pracy agenta; dalsze kroki opisuje [README](README.md).
14
+
15
+ Po zgodzie człowieka na kartę potwierdzoną w `ready` CEO domyślnie uruchamia Buildera przez `ceo-client-launcher` → `spawn_builder`. Ręczny start w nowym terminalu jest wyłącznie jawnym wyborem operatora; błąd pomocnika wymaga zgłoszenia i naprawy przyczyny przed ponowieniem, bez automatycznego przejścia na ręczny start. Instalator sam nie startuje usług w tle ani Buildera.
16
+
17
+ Ograniczenia: wszystkie trzy role muszą obecnie używać jednego dostawcy; mieszana mapa daje błąd `doctor`. Sam `doctor` nie potwierdza dostępności narzędzi obu pomocników w sesji dostawcy — sprawdź je zgodnie z README. W Claude Code niezależny Quality Officer przez `Agent(quality-officer-client)`, dowody i verified receipt poprzedzają `delivered`, a jawny odbiór operatora poprzedza `done`. OpenCode pozostaje w `in_review` niezależnie od dostępności Agent, bez wspieranego przejścia do `delivered`; pełny odbiór wymaga ścieżki Claude Code. Codex wymaga integracji Agent, niezależnej recenzji i verified receipt; brak Agent pozostawia kartę w `in_review` do naprawy CEO/CR. Builder nie recenzuje własnej pracy.
18
+
19
+ Biblioteki ESM w `dist/` obejmują parser konfiguracji `engine-config`, wyniki ról `role-results`, SDK tablicy `planer-client` ([API silnika](ENGINE-API.md)), rejestr ról, politykę sparse (`sparse-policy`), walidację zasiewu i reguły intencji, wybór i zakres pracy, ruchy i odzyskiwanie stanu, tożsamość prób/testera, środowisko Workera, źródła recenzji, wyniki CI oraz adaptery Claude/Codex/OpenCode i eksport sesji. `robisie.config.json` opisuje instancję: projekt, tory, katalog stanu i role; sekcja `engine` opisuje repo, gałąź, komendy, wymagane kontrole i sposób dostarczenia. Parser konfiguracji niczego nie uruchamia. Instalacja, import bibliotek i obecność pomocników nie dowodzą uruchomienia silnika ani pełnej autonomicznej pętli klienta.
20
+
21
+ Powrót lokalny: zachowaj poprzedni tgz i kopię własnej konfiguracji; w tym samym projekcie zainstaluj go przez `npm i ./robisie-0.1.0.tgz`, potem `npx robisie init --agent <agent>` i `npx robisie doctor`. Najpierw sprawdź zgodność kontraktu. Test 0.1.0 → syntetyczne 0.1.1 → 0.1.0 jest lokalną próbą reinstalacji i powrotu, nie rollbackiem opublikowanych wydań. `npx robisie uninstall` usuwa zarejestrowane wpisy/bloki robisie, nie przywraca starych wpisów robisie; cofa niezmienione role, a zmienione przez użytkownika pozostawia z ostrzeżeniem. Backupy pozostają i mogą zawierać klucz — chroń je. Bez zapisu instalacji komenda nie usuwa pliku klucza; odmowa sprawdzenia konfiguracji Codex następuje przed usunięciem klucza, a po tym sprawdzeniu klucz jest usuwany nawet przy późniejszym błędzie. Kod różny od zera wymaga rozwiązania wskazanego problemu. Uninstall nie unieważnia klucza na serwerze (zrób to osobno w Connect); `npm uninstall robisie` usuwa paczkę z projektu, zgodnie z README.
22
+
23
+ Ten dokument nie potwierdza tagu, GitHub Release ani publikacji npm.
24
+
25
+ ## English
26
+
27
+ 0.1.1 collects fixes for installation, private file permissions, backups, refusal of credential-bearing MCP redirects, safe diagnostics and recovery, plus client API libraries. [CHANGELOG](https://github.com/chuppa12/robisie-app/blob/main/packages/client/CHANGELOG.md) lists exactly 45 locally accepted cards (E3: 26, E4: 4, E5: 3, E6: 12). Local acceptance establishes neither publication nor behavior of the version installed from npm.
28
+
29
+ 0.1.1 acceptance limits: step 5 of `805aad70`, covering roles and helpers in a real Claude Code session, remains unverified; helpers were checked directly through `robisie mcp`. The Bash profile for `80931e36` was checked with macOS simulated on Linux; the real Mac run remains open. Local acceptance for `9d10bca2` and `13bafb12` covers the package consumer; integration with the customer service requires separate acceptance. A refused `init` may leave a partial installation (`1bd3a86d`); resolve the reported problem and check its state before retrying. Installation does not remove these limits.
30
+
31
+ The client connects Claude Code, Codex CLI or OpenCode to the robisie board. `init` installs MCP configuration, CEO, Builder and Quality Officer roles and the `client-launch-context` and `ceo-client-launcher` helper commands. `doctor` checks the connection and installation; `uninstall` removes recorded changes. Other settings and instructions survive; first backups retain the state before installation.
32
+
33
+ Requirements for 0.1: macOS or Linux, Node.js >=20, npm, an installed agent with your own AI provider access, a robisie connection and a Connect key. Windows/WSL support is unverified. The client supports server contract 1.x, currently 1.0.0. `init` refuses another major, such as 2.0.0, before writing; an older client cannot downgrade the server contract.
34
+
35
+ Candidate installation: `npm i ./robisie-0.1.1.tgz`; after confirmed publication: `npm i robisie@0.1.1` in the agent working directory; follow [README](README.en.md) for the next steps.
36
+
37
+ After human approval of a card confirmed in `ready`, the CEO starts the Builder by default through `ceo-client-launcher` → `spawn_builder`. Manual startup in a new terminal is only the operator's explicit choice; a helper error must be reported and its cause resolved before retrying, without automatically switching to manual startup. The installer itself starts neither background services nor the Builder.
38
+
39
+ Limitations: all three roles currently need the same provider; `doctor` rejects mixed assignments. `doctor` alone does not confirm that both helpers' tools are available in the provider session — check them as described in README. In Claude Code, an independent Quality Officer through `Agent(quality-officer-client)`, evidence and a verified receipt precede `delivered`; explicit operator acceptance precedes `done`. OpenCode stays in `in_review` regardless of Agent availability, with no supported transition to `delivered`; full acceptance requires the Claude Code path. Codex requires Agent integration, independent review and a verified receipt; without Agent, the card stays in `in_review` pending CEO/CR repair. The Builder does not review its own work.
40
+
41
+ The ESM libraries in `dist/` include the `engine-config` configuration parser, `role-results` role outcomes, the `planer-client` board SDK ([engine API](ENGINE-API.md)), role registry, sparse policy (`sparse-policy`), seed validation and intent rules, selection and dispatch scope, outcome moves and recovery, attempt/tester identity, Worker environment, review source packets, CI results, Claude/Codex/OpenCode adapters and session export. `robisie.config.json` describes an instance: project, tracks, state directory and roles; its `engine` section describes the repository, branch, commands, required checks and delivery mode. Parsing configuration starts nothing. Installation, library imports and shipped helpers do not prove a running engine or a complete autonomous customer loop.
42
+
43
+ Local return: retain the previous tgz and a copy of your configuration. Install it in the same project with `npm i ./robisie-0.1.0.tgz`, then run `npx robisie init --agent <agent>` and `npx robisie doctor`, checking contract compatibility first. The 0.1.0 → synthetic 0.1.1 → 0.1.0 test is a local reinstall and return rehearsal, not a rollback of published releases. `npx robisie uninstall` removes recorded robisie entries/blocks without restoring old robisie entries; it restores unchanged role files and leaves user-edited roles with a warning. Backups remain and may contain a key; protect them. Without an installation record, the key file is not removed; Codex configuration refusal happens before key deletion, while after that check the key is removed even if a later step fails. A nonzero exit requires resolving the reported problem. Uninstall does not revoke the server key (revoke it separately in Connect); `npm uninstall robisie` removes the project package, as described in README.
44
+
45
+ This document does not confirm a tag, GitHub Release or npm publication.
46
+
47
+ ## Wspólny przykład PL/EN / Shared PL/EN example
48
+
49
+ Przykład zwraca konfigurację instancji bez uruchamiania silnika; `./state` jest liczone względem pliku konfiguracji. / The example returns instance configuration without starting the engine; `./state` is resolved relative to the configuration file.
50
+
51
+ <!-- release-surface:example:start -->
52
+ ```js
53
+ import { parseConfig } from 'robisie/dist/engine-config.js';
54
+
55
+ export const config = parseConfig({
56
+ project: 'example-project',
57
+ tracks: [{ id: 'example-track', name: 'Praca' }],
58
+ stateDir: './state',
59
+ }, '/example/robisie.config.json');
60
+ ```
61
+ <!-- release-surface:example:end -->
62
+
63
+ ## Zawartość paczki / Package inventory
64
+
65
+ Ścieżki bibliotek/CLI i pomocników; wpis przy launcherze wskazuje zarejestrowane narzędzie. Deklaracje `.d.ts` mogą towarzyszyć modułom JS. / Library/CLI and helper paths; the launcher entry names its registered tool. Type declarations may accompany JS modules.
66
+
67
+ <!-- release-surface:inventory:start -->
68
+ - `dist/active-recovery.js`
69
+ - `dist/agents.js`
70
+ - `dist/attempt-identity.js`
71
+ - `dist/ci-failure-result.js`
72
+ - `dist/claude-headless.js`
73
+ - `dist/cli.js`
74
+ - `dist/commands.js`
75
+ - `dist/constants.js`
76
+ - `dist/context.js`
77
+ - `dist/dependency-readiness.js`
78
+ - `dist/dispatch-scope.js`
79
+ - `dist/done-evidence.js`
80
+ - `dist/engine-config.js`
81
+ - `dist/fsops.js`
82
+ - `dist/helpers.js`
83
+ - `dist/intent-rules/admission.js`
84
+ - `dist/intent-rules/done-when-roles.js`
85
+ - `dist/intent-rules/hooks.js`
86
+ - `dist/k3-codex-role.js`
87
+ - `dist/manifest.js`
88
+ - `dist/mcp.js`
89
+ - `dist/opencode-result.js`
90
+ - `dist/opencode-review-guard.js`
91
+ - `dist/opencode-session-export.js`
92
+ - `dist/outcome-moves.js`
93
+ - `dist/planer-client.js`
94
+ - `dist/restart-recovery.js`
95
+ - `dist/review-source-packet.js`
96
+ - `dist/role-registry.js`
97
+ - `dist/role-results.js`
98
+ - `dist/roles.js`
99
+ - `dist/seed-validation.js`
100
+ - `dist/selection-result.js`
101
+ - `dist/sparse-policy.js`
102
+ - `dist/tester-identity.js`
103
+ - `dist/worker-env.js`
104
+ - `helpers/ceo-client-launcher-mcp.mjs` → `spawn_builder`
105
+ - `helpers/client-launch-context-mcp.mjs`
106
+ - `helpers/client-spawn-session.sh`
107
+ - `helpers/client-spawn.sh`
108
+ - `helpers/lib/client-review-receipt.mjs`
109
+ - `helpers/lib/client-spawn-failure.mjs`
110
+ <!-- release-surface:inventory:end -->