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/CHANGELOG.md CHANGED
@@ -1,11 +1,90 @@
1
1
  # Historia zmian klienta / Client changelog
2
2
 
3
+ ## 0.1.2 (2026-11-03)
4
+
5
+ Wydanie poprawek klienta i dokumentacji. / Client and documentation patch release.
6
+
7
+ - Publikacja rozpakowanego `package/` z kontrolą zgodności repacka przed publikacją i odczytem README z rejestru po publikacji (#689). / Publish the extracted `package/`, verify repack integrity before publication and read back the registry README afterwards (#689).
8
+ - Przewodniki pierwszej instalacji i przywracania tgz zachowują istniejące manifesty projektu, zatrzymują instalację po pierwszym błędzie i wskazują dokumentację zainstalowanej paczki. / First-install and tgz restore guides preserve existing project manifests, stop installation at the first error and point to the installed package documentation.
9
+ - Zimny start `doctor` prowadzi przez konto i `init`; walidacja pomocników odbywa się poza procesem doctor, a sprzątanie zachowuje bezpieczne błędy pomocników. / Cold-start `doctor` guides users through account setup and `init`; helper validation runs outside the doctor process and cleanup preserves safe helper failures.
10
+ - Limit rozmiaru odpowiedzi MCP; stałe błędy nieobsługiwanych zdarzeń OpenCode i diagnostyka bez nieznanych kluczy rejestru ról. / MCP response size budget; constant errors for unsupported OpenCode events and diagnostics without unknown role registry keys.
11
+ - Przykład konfiguracji ogranicza wynik do liczników; dokumentacja API zachowuje wynik operacji przy błędzie sprzątania. / Configuration example output is limited to counts; API documentation preserves operation outcomes when cleanup fails.
12
+
13
+ ## 0.1.1 (2026-10-30)
14
+
15
+ Wydanie utrzymaniowe: bezpieczniejsza instalacja, odzyskiwanie i diagnostyka oraz biblioteki klienta. Poniższe 45 kart ma odbiór **TAK lokalnie**; sprawdzenie wersji z rejestru npm pozostaje osobną bramką. / Maintenance release: safer installation, recovery and diagnostics, plus client libraries. The following 45 cards have **local acceptance**; verification of the npm registry release remains a separate gate.
16
+
17
+ ### E3
18
+
19
+ - `10393507` — init i doctor uwzględniają wersję kontraktu każdej odpowiedzi.
20
+ - `13bafb12` — odbiorca klienta ustala dokładny kandydat do sprawdzenia.
21
+ - `18235645` — paczka wybiera rozłączne zakresy równoległych kart.
22
+ - `2e9242da` — klient rozróżnia awarię CI i błąd kodu z dostarczonych wyników.
23
+ - `4316e68e` — recenzent klienta czyta raport związany z kartą i kandydatem.
24
+ - `5084ba5e` — uninstall zachowuje rolę, gdy brakuje jej oryginału w kopii.
25
+ - `59255cbe` — doctor wykrywa brak instrukcji uruchomienia zainstalowanych ról.
26
+ - `695e6eed` — klient sprawdza komplet lokalnego pakietu bez skryptu hosta.
27
+ - `737bbf62` — reguły intencji klienta używają ról jego instancji.
28
+ - `78225362` — uninstall zachowuje manifest do zakończenia sprzątania.
29
+ - `79f7e41f` — doctor sprawdza kontekst projektu używany przez pomocnik klienta.
30
+ - `80931e36` — init zachowuje działający profil logowania Bash.
31
+ - `8d297c6f` — niepełny ostatni werdykt nie odziedzicza wcześniejszego PASS.
32
+ - `945c44b9` — init sprawdza odczyt wszystkich docelowych plików przed pierwszym zapisem.
33
+ - `9d10bca2` — paczka odtwarza aktywne zadania z zachowanej tożsamości.
34
+ - `a6e291b6` — instalacja odmawia względnych katalogów konfiguracji.
35
+ - `af3a5bc3` — init odrzuca znane konflikty konfiguracji przed zapisaniem instalacji.
36
+ - `b9402172` — klient rozpoznaje rzeczywiście odebrane zależności karty.
37
+ - `bb29afd9` — klient API tworzy pierwszy tor i szkic karty.
38
+ - `da4ddc8e` — konsument TypeScript korzysta z typów zainstalowanej paczki.
39
+ - `dcf3218b` — doctor potwierdza pełny start pomocnika przed uznaniem go za sprawnego.
40
+ - `dd86b397` — paczka wiąże dowód startu z właściwą próbą zadania.
41
+ - `e65b667c` — uszkodzona ewidencja instalacji odmawia przed zmianą plików.
42
+ - `fb07c02f` — klient zachowuje decyzję odzyskania pracy po restarcie.
43
+ - `ff361096` — odczyt karty z API paczki zachowuje indeks jej pełnych danych.
44
+ - `ff998946` — klient odczytuje pełną odpowiedź selektora bez importu hosta.
45
+
46
+ ### E4
47
+
48
+ - `b231a265` — obcy agent uruchamia przykład konfiguracji silnika z paczki.
49
+ - `c781f9f0` — agent korzysta z API paczki bez zgadywania odczytu i ponowienia.
50
+ - `deb1e7d2` — doctor odróżnia niedostępny plik instalacji od braku klucza.
51
+ - `805aad70` — Operator B podłącza paczkę bez klucza w argumentach i bez kasowania cudzego MCP.
52
+
53
+ ### E5
54
+
55
+ - `0b0940cc` — powrót klienta przechodzi przez dwa rzeczywiste archiwa paczki.
56
+ - `5e579f94` — ponowne pakowanie usuwa wycofane artefakty klienta.
57
+ - `6964272e` — notatka wydania odpowiada faktycznej zawartości klienta.
58
+
59
+ ### E6
60
+
61
+ - `1bd3a86d` — niepełny zagnieżdżony blok nie usuwa cudzych instrukcji.
62
+ - `31a377ef` — init przywraca prywatność własnego katalogu instalacji.
63
+ - `3b250acb` — kopie konfiguracji klienta pozostają w prywatnym katalogu.
64
+ - `58a45de0` — eksport sesji klienta nie interpretuje identyfikatora jako polecenia.
65
+ - `5b8dd7f5` — ponowny init przywraca ochronę prywatnej konfiguracji bez zmiany jej treści.
66
+ - `6fddbaec` — init nie przekazuje poświadczenia pod adres z przekierowania.
67
+ - `8b9882ba` — błąd połączenia klienta nie kopiuje sekretu do diagnostyki.
68
+ - `ac688abb` — role planowania i recenzji OpenCode nie dostają powłoki ani edycji.
69
+ - `ad251014` — nieudany proces Codex nie przenosi stderr ani cause do wyjątku klienta.
70
+ - `af5c973c` — odmowa pomocnika nie przenosi jego sekretów do doctor.
71
+ - `ccf5a385` — parser konfiguracji paczki nie powiela obcej wartości w błędzie.
72
+ - `e5413393` — instalator nie zamienia cudzych bajtów konfiguracji na znaki zastępcze.
73
+
74
+ Ograniczenia odbioru: `805aad70` — krok 5 z rolami i pomocnikami w prawdziwej sesji Claude Code pozostaje niesprawdzony; `80931e36` — profil Bash sprawdzono z symulacją macOS na Linuksie, rzeczywisty przebieg na Macu pozostaje otwarty. `9d10bca2` i `13bafb12` potwierdzają konsumenta paczki; integracja z usługą klienta wymaga osobnego odbioru. / Acceptance limits: the real Claude Code session for step 5 of `805aad70` and the real Mac Bash run for `80931e36` remain unverified. `9d10bca2` and `13bafb12` establish package consumer behavior; customer service integration needs separate acceptance.
75
+
76
+ Pełny opis, wymagania i granice: [notatka PL/EN 0.1.1](docs/RELEASE-0.1.1.md). / Requirements, behavior and limits: [0.1.1 PL/EN release note](docs/RELEASE-0.1.1.md).
77
+
3
78
  ## 0.1.0
4
79
 
5
80
  Kandydat pierwszego wydania, bez daty publikacji. / First release candidate, no publication date.
6
81
 
7
82
  - `init`, `doctor`, `uninstall` dla Claude Code, Codex CLI i OpenCode; role CEO, Builder i Quality Officer.
8
83
  - Pomocniki `client-launch-context` i `ceo-client-launcher` dostarczane w paczce, polecenia przypięte do wersji klienta.
84
+ - Po zgodzie na kartę `ready`: CEO → `ceo-client-launcher` → `spawn_builder`; ręczny start wyłącznie z wyboru operatora. / After approval of a `ready` card, the CEO starts the Builder through the launcher; manual startup is the operator's explicit choice.
85
+ - Biblioteki ESM: `engine-config`, `role-results`, `planer-client`, rejestr ról, walidacja zasiewu/reguły intencji, wybór/zakres, ruchy/odzyskiwanie, tożsamość prób/testera, środowisko Workera, źródła recenzji, wyniki CI i adaptery Claude/Codex/OpenCode z eksportem sesji. Konfiguracja instancji w `robisie.config.json`; wykaz i przykład w [notatce PL/EN](docs/RELEASE-0.1.0.md), SDK w [API silnika](docs/ENGINE-API.md). / ESM configuration, role outcomes, board SDK and engine support libraries are shipped; imports and helpers do not prove a running engine or an autonomous loop.
86
+ - Instalator nie startuje tła/Buildera; doctor nie dowodzi dostępności narzędzi u dostawcy. Claude Code wymaga niezależnej recenzji, verified receipt i odbioru; OpenCode zostaje w `in_review`, Codex wymaga integracji Agent. / Installation and doctor do not establish provider capabilities or acceptance: independent review, verified receipt and operator acceptance remain required; OpenCode stops at `in_review`, Codex needs Agent integration.
87
+ - Wymagania 0.1: macOS/Linux, Node >=20; wsparcie Windows/WSL niezweryfikowane. / Requirements: macOS/Linux, Node >=20; Windows/WSL support is unverified.
9
88
  - Kontrakt serwera 1.x (obecnie 1.0.0); odmowa innego major przed zapisem konfiguracji.
10
89
  - Ochrona obcych ustawień i instrukcji, pierwsze kopie zapasowe oraz przywracanie własnych plików po uninstall; zmienione role pozostają z ostrzeżeniem.
11
90
  - Zapisywanie dostawcy dla każdej roli i diagnoza ograniczeń; bieżąca pętla wymaga jednego dostawcy dla wszystkich trzech ról.
package/README.md CHANGED
@@ -1,28 +1,123 @@
1
- # robisie 0.1.0
1
+ # robisie
2
2
 
3
- Przewodnik dla otrzymanego `robisie-0.1.0.tgz`: [PL — konto → odbiór → odinstalowanie](docs/README.md) · [EN — account → acceptance → uninstall](docs/README.en.md). Zacznij od wymagań, konta i klucza w przewodniku. Przygotuj Node.js 20+, npm, program jednego dostawcy AI oraz pusty katalog z tgz i README; strona i package.json nie są potrzebne. Projekt w panelu i katalog na dysku to osobne rzeczy; CEO wymaga dokładnie jednego projektu z discovery.
3
+ Przewodniki: [PL — konto → odbiór → odinstalowanie](docs/README.md) · [EN — account → acceptance → uninstall](docs/README.en.md). Przygotuj Node.js 20+, npm, program jednego dostawcy AI oraz pusty katalog; nie potrzebujesz strony ani własnego pliku `package.json` — utworzy go poniższy krok Node.js przed instalacją. Zacznij od konta i projektu w panelu. Projekt w panelu i katalog na dysku to osobne rzeczy; CEO wymaga dokładnie jednego projektu z discovery.
4
4
 
5
- Człowiek generuje klucz worker z etykietą w Connect i podaje go poza rozmową do ukrytego pytania init. W zsh/bash usuń stary ENV, a po udanym init wczytaj zapisany klucz do bieżącej powłoki bez wyświetlania go — init nie ustawia jej środowiska. Dla pierwszej próby Claude:
5
+ Konto i klucz są potrzebne do init i pracy ról. Osobno `npx robisie doctor --engine-config ./robisie.config.json` sprawdza offline tylko strukturę: nie potwierdza UUID projektu, repo, modeli ani uruchomienia dostawców. Lokalne przewodniki są w `node_modules/robisie/docs/`.
6
+
7
+ ## Przed init — konto i pierwszy projekt
8
+
9
+ Załóż konto i zaloguj się w https://robisie.app. Ekran „Zakładamy Twój projekt…” oznacza przygotowywanie projektu; poczekaj na „Twój projekt jest gotowy”. Ten ekran nie dowodzi dokładnie jednego projektu. Nie ma gwarantowanego czasu oczekiwania. Jeśli widzisz „To się przeciąga…”, wybierz „Sprawdź tablicę”: https://robisie.app/dashboard/plugins/planer.
10
+
11
+ Na liście projektów, tylko gdy nie masz przygotowanego projektu, wpisz nazwę w „Nazwa projektu (np. robisie)” i wybierz „Załóż projekt”. Nie twórz drugiego projektu, jeśli pierwszy już jest przygotowany.
12
+
13
+ Jeśli trasa przekierowała na /dashboard bez Planera, znajdź „Zacznij od pierwszego projektu”, wpisz „Nazwa projektu” i wybierz „Stwórz projekt”. Również tutaj twórz projekt tylko wtedy, gdy nie masz jeszcze przygotowanego projektu. Potem przejdź do Connect.
14
+
15
+ ## Init — połącz agenta
16
+
17
+ Człowiek generuje klucz worker z etykietą w https://robisie.app/dashboard/connect i podaje go poza rozmową do ukrytego pytania init, nigdy do czatu, argumentu polecenia ani historii powłoki. W zsh/bash usuń stary ENV, a po udanym init wczytaj zapisany klucz do bieżącej powłoki bez wyświetlania go — init nie ustawia jej środowiska. Dla nowej instalacji z Claude wejdź do wybranego pustego katalogu (zastąp przykładową ścieżkę poniżej). Poniższy krok Node.js tworzy lokalny `package.json` niezależnie od nazwy katalogu, także ze spacjami i polskimi znakami. Manifest ustala katalog instalacji także pod przodkiem z `node_modules`. Jeśli ścieżka `package.json` już istnieje (również jako link), krok odmawia zapisu; niczego nie nadpisuje. Błąd wejścia do katalogu lub utworzenia manifestu zatrzymuje dalszy blok:
6
18
 
7
19
  ```sh
8
- npm i ./robisie-0.1.0.tgz
9
- unset ROBISIE_KEY
10
- npx robisie init --agent claude --role ceo=claude --role builder=claude --role quality=claude
11
- [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] && export ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key")"
20
+ cd "/ścieżka/do/pustego katalogu" &&
21
+ node -e 'try {
22
+ require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
23
+ } catch (error) {
24
+ console.error(error.message);
25
+ process.exit(1);
26
+ }' &&
27
+ {
28
+ npm i robisie &&
29
+ unset ROBISIE_KEY &&
30
+ npx robisie init --agent claude &&
31
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
32
+ ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key")" &&
33
+ export ROBISIE_KEY &&
12
34
  npx robisie doctor
35
+ }
13
36
  ```
14
37
 
15
- Dla Codex/OpenCode zastąp wszystkie cztery nazwy dostawcy. Sam --agent nie usuwa wcześniejszej mapy. Nowy terminal wymaga obsługi profilu zsh/bash bez --no-shell; w innych sesjach wczytaj środowisko zgodnie z przewodnikiem. Agenta uruchom z katalogu instalacji i sprawdź narzędzia obu pomocników: doctor startuje je przez node, agent przez npx; ROBISIE_PROJECT_CONTEXT nie zmienia cwd szukania paczki.
38
+ Łańcuch `&&` zatrzymuje blok po pierwszym błędzie; osobne przypisanie przed `export` zachowuje błąd odczytu klucza. Po naprawieniu przyczyny ponów nieudany krok i wszystkie następne w tym samym katalogu. Jeśli manifest już powstał, nie twórz go ponownie ani go nie usuwaj. Nie włączaj xtrace ani nie drukuj sekretu.
39
+
40
+ W istniejącym projekcie zachowaj manifest i użyj instrukcji aktualizacji.
41
+
42
+ Dla Codex lub OpenCode zastąp `claude` przez `codex` lub `opencode`. Sam `--agent` nie usuwa wcześniejszej mapy ról: przy wcześniejszej konfiguracji użyj pełnej mapy z sekcji init w przewodniku. Nowy terminal wymaga obsługi profilu zsh/bash bez `--no-shell`; w innych sesjach wczytaj środowisko zgodnie z przewodnikiem. Agenta uruchom z katalogu instalacji; szczegóły startu ról, pomocników i diagnozy są w przewodnikach PL/EN powyżej.
43
+
44
+ ## Po init — sprawdź gotowość CEO
45
+
46
+ Po Connect, init i wczytaniu klucza według bloku powyżej uruchom `npx robisie doctor`. Discovery to odczyt aktywnych projektów przez `list_projects`. Nie wymaga wpisywania UUID. Sam `init` z exit 0 ani „połączono” nie wystarczają do potwierdzenia gotowości CEO.
47
+
48
+ - **0 projektów, exit 1:** `CEO wymaga dokładnie 1 projektu (projektów: 0).` Następny krok: `Sprawdź gotowość projektu na https://robisie.app/dashboard/plugins/planer.` Wróć do przygotowania projektu opisanego przed init.
49
+ - **Więcej niż 1 projekt, exit 1** (np. `CEO wymaga dokładnie 1 projektu (projektów: 2).`): `Uporządkuj widoczność projektów w discovery do 1; sam wybór projektu w panelu nie zmienia discovery.` Człowiek sam decyduje, który projekt zachować aktywny; przy pozostałych na liście wybiera „Archiwizuj”. „Archiwum” → „Przywróć” cofa archiwizację. Nie usuwaj projektów. Kliknięcie projektu nie zawęża discovery.
50
+ - **1 projekt:** oczekuj dokładnie `✓ Połączenie działa: klucz otwiera tablicę (projektów: 1).` oraz końcowego `Wszystko działa. Uruchom swojego agenta i poproś o rolę robisie CEO.` i exit 0.
51
+
52
+ Po zmianie ponów `npx robisie doctor`. Rozwiąż też inne błędy doctor: sam licznik 1 nie wystarcza bez końcowego komunikatu sukcesu i exit 0.
53
+
54
+ Po sukcesie człowiek potwierdza nazwę i cel projektu oraz katalog instalacji, bez klucza i UUID. Przejdź do startu CEO poniżej; to nie jest odbiór karty.
55
+
56
+ ## Start CEO
57
+
58
+ Człowiek uruchamia CEO w katalogu instalacji.
16
59
 
17
- Człowiek startuje CEO i ręcznie Buildera. Niezależną recenzję uruchamia CEO przez Agent; bez tego narzędzia w Codex/OpenCode praca pozostaje in_review i wymaga naprawy integracji przez CEO/CR. Worker nie ustawia done; człowiek odbiera wynik w panelu po dowodach i recenzji. Pełne polecenia, wynik pierwszej próby, naprawy, aktualizacja z tgz i uninstall są w PL/EN powyżej.
60
+ Po zgodzie człowieka CEO domyślnie wywołuje `spawn_builder` z ID karty potwierdzonej w `ready`.
18
61
 
19
- Wybór i zmiana dostawcy ról:
62
+ Przy błędzie `spawn_builder` CEO zgłasza błąd i naprawia przyczynę przed ponowieniem; nie przełącza automatycznie na ręczny start.
63
+
64
+ Ręczny start to wyłącznie jawny wybór operatora: wtedy CEO podaje polecenie do uruchomienia w nowym terminalu w katalogu instalacji.
65
+
66
+ W Claude Code CEO uruchamia niezależnego Quality Officera przez `Agent(quality-officer-client)`. Quality Officer sprawdza wynik i zapisuje recenzję oraz dowody; Builder nie recenzuje własnej pracy. CEO weryfikuje potwierdzenie recenzji (verified receipt) i wykonuje świeże odczyty karty przed przejściem do `delivered`; następnie jawny odbiór operatora w panelu pozwala przejść do `done`. Worker nie ustawia `done`. Sam `init`/`doctor` nie daje `done`.
67
+
68
+ OpenCode: karta pozostaje w `in_review` niezależnie od dostępności narzędzia Agent; brak wspieranego przejścia do `delivered`. Pełny odbiór wymaga opisanej w przewodnikach drogi Claude Code.
69
+
70
+ Codex: przejście do delivered wymaga niezależnej recenzji oraz zweryfikowanego potwierdzenia (verified receipt). Jeśli w sesji CEO brakuje narzędzia Agent, karta pozostaje w `in_review` i wymaga naprawy integracji przez CEO/CR.
71
+
72
+ Wszystkie trzy role muszą używać jednego dostawcy; mieszana mapa daje kod 1 doctor. Paczka nie uruchamia usług w tle ani nie zapewnia konta lub dostępu do AI.
73
+
74
+ Aktualizuj w katalogu instalacji po prywatnej kopii opisanej w przewodnikach. Init nie czyta automatycznie pliku key: pierwszeństwo ma ROBISIE_KEY, potem ukryte pytanie, potem jawny `--key-stdin`. Wczytaj stary klucz przed init/doctor z tym samym XDG_CONFIG_HOME, bez xtrace i bez wydruku:
20
75
 
21
76
  ```sh
22
- npx robisie init --role ceo=claude --role builder=codex --role quality=opencode
23
- npx robisie init --role=builder=claude
77
+ set +x
78
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
79
+ ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key")" &&
80
+ export ROBISIE_KEY &&
81
+ npm i robisie@latest &&
82
+ npx robisie init &&
83
+ npx robisie doctor
24
84
  ```
25
85
 
26
- Dostawcy: `claude`, `codex`, `opencode`; role: `ceo`, `builder`, `quality`. Mapa pozostaje po ponownym init; zmiana jednej roli zachowuje pozostałe. Każdy wskazany dostawca oraz `--agent` otrzymuje komplet ról, MCP i pomocników; poprzedni pozostaje do pełnego uninstall. Bez `--agent` init uwzględnia także wszystkich wykrytych dostawców, również nowo zainstalowanych przy ponownym uruchomieniu. Stary manifest z jednym dostawcą przypisuje mu trzy role; z wieloma zapisuje null. Init bez wyboru nadal działa; jawny wybór wymaga pełnej wynikowej mapy. Wadliwa mapa blokuje init, ale nie uninstall po entries.
86
+ Doctor sprawdza MAJOR kontraktu. Przy niezgodności wybierz zgodne wydanie. Poprzedni zgodny tgz przygotuj przez `npm pack robisie@<wersja>`; komenda powrotu `npm i --no-save "$backup/robisie-$previous_version.tgz"` wymaga jawnie wybranej wersji, prywatnej kopii konfiguracji i porównania późniejszych własnych zmian według przewodników. Opcja `--no-save` zachowuje przywrócone `package.json` i `package-lock.json`, bez zapisywania zależności `file:` od ścieżki prywatnej kopii. Kolejność powrotu: konfiguracja i tgz → ENV starego klucza → init → doctor. To nie jest automatyczny rollback.
87
+
88
+ Pomocniki uruchamiaj z cwd instalacji przez `npx robisie mcp <nazwa>`; init nadal generuje transport dla wersji paczki. npx może pobrać brakującą wersję z sieci. Bez instalacji zacznij od konta → init; przy istniejącej instalacji rozwiąż błędy ewidencji i odczytu klucza przed błędami sieci. Odinstalowanie może zmienić package.json, package-lock.json i node_modules; cache npm może zostać, a npx może pobrać paczkę ponownie. Bez masowego kasowania. Windows/WSL są niezweryfikowane.
89
+
90
+ ## Lokalna walidacja konfiguracji wykonania
91
+
92
+ Zapisz konfigurację projektu i osobny rejestr wykonania w `robisie.config.json`:
93
+
94
+ ```json
95
+ {
96
+ "project": "uuid-projektu",
97
+ "tracks": [{"id": "uuid-toru", "name": "Tor główny"}],
98
+ "stateDir": "./stan",
99
+ "engine": {
100
+ "repo": "./repo",
101
+ "branch": "main",
102
+ "commands": {
103
+ "test": ["npm", "test"],
104
+ "lint": ["npm", "run", "lint"],
105
+ "build": ["npm", "run", "build:check"]
106
+ },
107
+ "requiredChecks": ["test", "lint"],
108
+ "delivery": "pr"
109
+ },
110
+ "roleRegistry": {
111
+ "worker-client": {"name":"Ola","provider":"codex","model":"gpt-6.1-sol","effort":"high"},
112
+ "lead-client": {"name":"Leon","provider":"claude","model":"opus","effort":"medium"},
113
+ "reviewer-client": {"name":"Iga","provider":"opencode","model":"opencode-go/gpt-6-luna","effort":"low"},
114
+ "tester-client": {"name":"Jan","provider":"grok","model":"grok-cli","effort":"none"}
115
+ }
116
+ }
117
+ ```
118
+
119
+ Uruchom `npx robisie doctor --engine-config ./robisie.config.json` (także `--engine-config=./robisie.config.json`). Ścieżka pliku jest względem bieżącego katalogu, a `repo` i `stateDir` względem pliku konfiguracji. Role projektu `coordinator/owner/planner/advisor` zachowują domyślne nazwy; opcjonalne pole `roles` służy ich nazwom i odmianie, osobno od `roleRegistry`.
120
+
121
+ Kod 0 oznacza poprawną strukturę konfiguracji i dokładnie cztery kompletne przypisania wykonania; raport pokazuje rolę → imię / dostawcę / model / wysiłek. Kod 1 wskazuje plik, błędne pole (jeśli dotyczy) i następny krok. Ten tryb działa offline, bez klucza, uruchamiania dostawców, wykonywania komend silnika ani zapisu plików. Raport jawnie stwierdza: „sprawdzono konfigurację; nie sprawdzono uruchomienia dostawców”. Zwykły `doctor` zachowuje dotychczasową diagnozę instalacji.
27
122
 
28
- Doctor pokazuje mapę i sprawdza programy w PATH. Mieszane role oznaczają kod 1: Quality Officer działa jako podagent u dostawcy CEO, a polecenie Buildera ma format dostawcy CEO. Wykonanie mieszanych ról to następny zakres. Szczegóły i diagnoza są w przewodnikach PL/EN powyżej.
123
+ Modele i wysiłki to przykładowe, dosłowne etykiety, bez gwarancji dostępności lub obsługi przez CLI. `grok-cli`/`none` opisują obecny review-job; nie dowodzą sterowania modelem ani wysiłkiem Groka. Imię jest metadanymi rejestru; Execution v1 zachowuje `{contractVersion:1,provider,model,effort}`. Walidacja nie jest odbiorem wykonania karty, dostawców ani całego procesu pracy.
@@ -0,0 +1,58 @@
1
+ export type CardLike = {
2
+ detailsReadError?: string | null;
3
+ id: string;
4
+ title: string;
5
+ trackId?: string | null;
6
+ status?: string | null;
7
+ assignee?: string | null;
8
+ details?: Record<string, unknown> | null;
9
+ };
10
+ export declare const ACTIVE_RECOVERY_DETAILS_KEYS: readonly ["maszynista", "review", "reksio_withheld"];
11
+ export type Active = {
12
+ taskId: string;
13
+ title: string;
14
+ trackId: string | null;
15
+ jobId: string;
16
+ worktree: string;
17
+ branch: string;
18
+ startedAt: string;
19
+ attempts: number;
20
+ backend?: "claude" | "codex" | "grok-cli" | "opencode";
21
+ model?: string;
22
+ opencode?: Readonly<{
23
+ pid: number;
24
+ pidPath: string;
25
+ promptPath: string;
26
+ stdoutPath: string;
27
+ stderrPath: string;
28
+ exitPath: string;
29
+ startedAt: string;
30
+ jobId: string;
31
+ model: string;
32
+ provider: "opencode-go";
33
+ sessionId: string | null;
34
+ messageId: string | null;
35
+ }>;
36
+ };
37
+ export declare function reconcileActive(input: {
38
+ stateActives: Active[];
39
+ boardCards: CardLike[];
40
+ assignee: string;
41
+ nowIso: string;
42
+ }): {
43
+ actives: Active[];
44
+ releases: Array<{
45
+ taskId: string;
46
+ status: "ready";
47
+ assignee: null;
48
+ }>;
49
+ adopted: Array<{
50
+ active: Active;
51
+ stamp: Record<string, unknown>;
52
+ orphan?: CardLike;
53
+ }>;
54
+ skipped?: Array<{
55
+ card: CardLike;
56
+ reason: string;
57
+ }>;
58
+ };
@@ -0,0 +1,143 @@
1
+ export const ACTIVE_RECOVERY_DETAILS_KEYS = ["maszynista", "review", "reksio_withheld"];
2
+ function record(value) {
3
+ return value !== null && typeof value === "object" && !Array.isArray(value);
4
+ }
5
+ function asRecord(value) {
6
+ return record(value) ? value : {};
7
+ }
8
+ function positiveInteger(value) {
9
+ return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
10
+ }
11
+ function nonempty(value) {
12
+ return typeof value === "string" && value.trim().length > 0;
13
+ }
14
+ function timestamp(value) {
15
+ return nonempty(value) && Number.isFinite(Date.parse(value));
16
+ }
17
+ export function reconcileActive(input) {
18
+ const previous = new Map(input.stateActives.map((active) => [active.taskId, active]));
19
+ const actives = [];
20
+ const releases = [];
21
+ const adopted = [];
22
+ const skipped = [];
23
+ const takeState = (card, fromState, worker) => {
24
+ const active = {
25
+ ...fromState,
26
+ title: card.title,
27
+ trackId: nonempty(card.trackId) ? card.trackId : null,
28
+ };
29
+ const meta = record(worker) ? worker : {};
30
+ const stamp = {
31
+ branchLease: meta.branchLease ?? null,
32
+ at: fromState.startedAt,
33
+ jobId: fromState.jobId,
34
+ worktree: fromState.worktree,
35
+ branch: fromState.branch,
36
+ attempts: fromState.attempts,
37
+ outcome: "dispatched",
38
+ };
39
+ if ("engine" in meta)
40
+ stamp.engine = meta.engine;
41
+ if (fromState.backend)
42
+ stamp.backend = fromState.backend;
43
+ if (fromState.model)
44
+ stamp.model = fromState.model;
45
+ if (fromState.opencode)
46
+ stamp.opencode = fromState.opencode;
47
+ actives.push(active);
48
+ adopted.push({ active, stamp });
49
+ };
50
+ for (const card of input.boardCards) {
51
+ const orphan = card.status === "in_review" && card.assignee == null && !previous.has(card.id);
52
+ if (card.assignee !== input.assignee && !orphan)
53
+ continue;
54
+ if (orphan) {
55
+ const worker = asRecord(card.details?.maszynista);
56
+ if (card.detailsReadError || card.details?.reksio_withheld === true
57
+ || worker.processStart != null)
58
+ continue;
59
+ if (worker.outcome === "ACTIONABLE_BLOCKER") {
60
+ skipped.push({ card, reason: "outcome=ACTIONABLE_BLOCKER — powrót przez blocked/ready" });
61
+ continue;
62
+ }
63
+ if (!["review", "landing"].includes(String(worker.phase))
64
+ || (worker.outcome !== "WORKER_FINISHED" && asRecord(card.details?.review).verdict !== "PASS"))
65
+ continue;
66
+ if (![worker.jobId, worker.worktree, worker.branch].every(nonempty) || !positiveInteger(worker.attempts)) {
67
+ skipped.push({ card, reason: "niepełne dane Workera (jobId, worktree, branch, attempts)" });
68
+ continue;
69
+ }
70
+ }
71
+ if (card.detailsReadError) {
72
+ const known = previous.get(card.id);
73
+ if (known)
74
+ actives.push(known);
75
+ continue; // No release/restamp can be justified without readable process identity.
76
+ }
77
+ const details = card.details ?? {};
78
+ const worker = details.maszynista;
79
+ const activeStatus = card.status === "in_progress"
80
+ || (card.status === "in_review" && record(worker) && ["review", "landing"].includes(String(worker.phase)));
81
+ if (!activeStatus)
82
+ continue;
83
+ const fromState = previous.get(card.id);
84
+ const cardJobId = record(worker) && nonempty(worker.jobId) ? worker.jobId : null;
85
+ // State wins: no jobId; different jobId without valid `at`; different jobId with older/equal `at`.
86
+ // Same jobId → card wins. Different jobId with strictly newer valid `at` → card wins. Attempts unused.
87
+ if (fromState && !cardJobId) {
88
+ takeState(card, fromState, worker);
89
+ continue;
90
+ }
91
+ if (fromState && cardJobId && cardJobId !== fromState.jobId) {
92
+ const cardAt = record(worker) ? worker.at : undefined;
93
+ const cardNewer = timestamp(cardAt) && Date.parse(cardAt) > Date.parse(fromState.startedAt);
94
+ if (!cardNewer) {
95
+ takeState(card, fromState, worker);
96
+ continue;
97
+ }
98
+ }
99
+ if (!record(worker) || !cardJobId) {
100
+ releases.push({ taskId: card.id, status: "ready", assignee: null });
101
+ continue;
102
+ }
103
+ const attempts = worker.attempts ?? worker.attempt;
104
+ // A known job must not be released and dispatched twice just because metadata is incomplete.
105
+ if (!nonempty(worker.worktree) || !nonempty(worker.branch) || !positiveInteger(attempts)) {
106
+ throw new Error(`Niepełne dane workera na karcie ${card.id}`);
107
+ }
108
+ if (worker.backend !== undefined && worker.backend !== "codex" && worker.backend !== "opencode") {
109
+ if (orphan) {
110
+ skipped.push({ card, reason: "nieobsługiwany backend Workera" });
111
+ continue;
112
+ }
113
+ throw new Error(`Nieobsługiwany backend workera na karcie ${card.id}`);
114
+ }
115
+ if ((worker.opencode !== undefined && worker.backend !== "opencode")
116
+ || (worker.backend === "opencode" && (!record(worker.opencode)
117
+ || !positiveInteger(worker.opencode.pid) || !nonempty(worker.model)
118
+ || ![worker.opencode.pidPath, worker.opencode.promptPath, worker.opencode.stdoutPath,
119
+ worker.opencode.stderrPath, worker.opencode.exitPath,
120
+ worker.opencode.jobId, worker.opencode.model].every(nonempty)
121
+ || worker.opencode.jobId !== cardJobId || worker.opencode.model !== worker.model
122
+ || worker.opencode.provider !== "opencode-go"))) {
123
+ if (orphan) {
124
+ skipped.push({ card, reason: "niepełna tożsamość OpenCode" });
125
+ continue;
126
+ }
127
+ throw new Error(`Niepełna tożsamość OpenCode na karcie ${card.id}`);
128
+ }
129
+ const old = previous.get(card.id);
130
+ const active = {
131
+ taskId: card.id, title: card.title, trackId: nonempty(card.trackId) ? card.trackId : null,
132
+ jobId: cardJobId, worktree: worker.worktree, branch: worker.branch, attempts,
133
+ startedAt: timestamp(worker.at) ? worker.at : old?.startedAt ?? input.nowIso,
134
+ ...(worker.backend === "opencode" || worker.backend === "codex" ? { backend: worker.backend } : {}),
135
+ ...(nonempty(worker.model) ? { model: worker.model } : {}),
136
+ ...(record(worker.opencode) ? { opencode: worker.opencode } : {}),
137
+ };
138
+ actives.push(active);
139
+ if (orphan)
140
+ adopted.push({ active, stamp: worker, orphan: card });
141
+ }
142
+ return { actives, releases, adopted, ...(skipped.length ? { skipped } : {}) };
143
+ }
@@ -0,0 +1,34 @@
1
+ import { type Ctx } from "./context.js";
2
+ import { type Op } from "./fsops.js";
3
+ import { type Role } from "./roles.js";
4
+ export declare const AGENT_IDS: readonly ["claude", "codex", "opencode"];
5
+ export type AgentId = (typeof AGENT_IDS)[number];
6
+ export declare const AGENT_LABELS: Record<AgentId, string>;
7
+ export declare function isAgentId(value: string): value is AgentId;
8
+ /** Where each agent keeps its user-level configuration (the same places the agents themselves read). */
9
+ export declare function agentPaths(ctx: Ctx): {
10
+ clientDir: string;
11
+ claudeDir: string;
12
+ claudeJson: string;
13
+ codexHome: string;
14
+ codexConfig: string;
15
+ codexAgentsMd: string;
16
+ opencodeDir: string;
17
+ opencodeJson: string;
18
+ opencodeJsonc: string;
19
+ };
20
+ export declare function agentOnPath(ctx: Ctx, id: AgentId): boolean;
21
+ /** Detection reads only the filesystem (config dir present, or binary on PATH) — nothing is executed. */
22
+ export declare function detectAgents(ctx: Ctx): AgentId[];
23
+ /** Keep a multiline string or array in its assignment, so its contents cannot look like server headers. */
24
+ export declare function tomlStatements(text: string): string[];
25
+ /**
26
+ * Take over an `[mcp_servers.robisie]` table written earlier by hand or by `codex mcp add` (otherwise
27
+ * Codex would see the table twice and refuse the whole config). Backups retain the old configuration.
28
+ */
29
+ export declare function removeCodexTables(text: string, removeInline?: boolean, codexHome?: string): string;
30
+ /** Every file change `init` makes for one agent. */
31
+ export declare function planAgent(ctx: Ctx, id: AgentId, roles: readonly Role[], key: string): Op[];
32
+ /** Shell profile line that exports ROBISIE_KEY from the package's key file (roles and Codex/OpenCode read it). */
33
+ export declare function shellProfile(ctx: Ctx): string | null;
34
+ export declare const SHELL_EXPORT = "[ -r \"${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key\" ] && export ROBISIE_KEY=\"$(cat \"${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key\")\"";