robisie 0.1.3 → 0.2.0

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 (52) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +73 -19
  3. package/dist/agents.d.ts +1 -1
  4. package/dist/agents.js +1 -1
  5. package/dist/ci-failure-result.js +1 -1
  6. package/dist/cli.d.ts +2 -0
  7. package/dist/cli.js +45 -8
  8. package/dist/codex-env.d.ts +9 -0
  9. package/dist/codex-env.js +60 -0
  10. package/dist/commands.js +140 -16
  11. package/dist/constants.d.ts +1 -1
  12. package/dist/constants.js +1 -1
  13. package/dist/delivery-local.d.ts +124 -0
  14. package/dist/delivery-local.js +286 -0
  15. package/dist/done-evidence.d.ts +25 -1
  16. package/dist/done-evidence.js +59 -1
  17. package/dist/engine/bundle-report.json +1687 -0
  18. package/dist/engine/tick.cjs +324704 -0
  19. package/dist/engine-config.d.ts +3 -1
  20. package/dist/engine-config.js +3 -3
  21. package/dist/factory-run.d.ts +17 -0
  22. package/dist/factory-run.js +262 -0
  23. package/dist/helpers.js +1 -1
  24. package/dist/k3-codex-job.d.ts +49 -0
  25. package/dist/k3-codex-job.js +324 -0
  26. package/dist/k3-helper-cli.d.ts +5 -0
  27. package/dist/k3-helper-cli.js +167 -0
  28. package/dist/local-usage.d.ts +47 -0
  29. package/dist/local-usage.js +230 -0
  30. package/dist/manifest.d.ts +5 -2
  31. package/dist/manifest.js +6 -6
  32. package/dist/opencode-review-guard.js +7 -2
  33. package/dist/planer-client.d.ts +45 -4
  34. package/dist/planer-client.js +120 -14
  35. package/dist/roles.d.ts +1 -1
  36. package/dist/seed-package.d.ts +10 -0
  37. package/dist/seed-package.js +62 -0
  38. package/dist/select-fingerprint.d.ts +19 -0
  39. package/dist/select-fingerprint.js +46 -0
  40. package/dist/task-mktemp.d.ts +1 -0
  41. package/dist/task-mktemp.js +40 -0
  42. package/dist/test-report.d.ts +9 -0
  43. package/dist/test-report.js +139 -0
  44. package/dist/tester-result-reader.d.ts +87 -0
  45. package/dist/tester-result-reader.js +122 -0
  46. package/docs/ENGINE-API.md +9 -1
  47. package/docs/README.en.md +161 -66
  48. package/docs/README.md +159 -66
  49. package/docs/RELEASE-0.1.0.md +29 -5
  50. package/helpers/ceo-client-launcher-mcp.mjs +76 -5
  51. package/package.json +6 -2
  52. package/roles/ceo-client.md +10 -8
package/CHANGELOG.md CHANGED
@@ -1,5 +1,27 @@
1
1
  # Historia zmian klienta / Client changelog
2
2
 
3
+ ## 0.2.0 (2026-11-07)
4
+
5
+ Pierwsze wydanie paczki z samodzielnym silnikiem. / First package release with a standalone engine.
6
+
7
+ - Tarball zawiera `dist/engine/tick.cjs` obok CLI. / The tarball includes `dist/engine/tick.cjs` alongside the CLI.
8
+ - `npx robisie factory run` (Linux, Node >=24) nadzoruje takty silnika; opcje: `--engine-config`, `--once`, `--interval`. Eskalacja (brak klucza odbioru B po receiver PASS, odmowa testera lub STOP odbioru) kończy takt kodem 2 i zatrzymuje nadzorcę z jedną linią diagnozy na stderr. / `npx robisie factory run` (Linux, Node >=24) supervises engine ticks; options: `--engine-config`, `--once`, `--interval`. Escalation (missing B acceptance key after receiver PASS, tester refusal or acceptance STOP) ends the tick with exit code 2 and stops the supervisor with one diagnostic line on stderr.
9
+ - `init` i `doctor` wymagają klucza odbioru B (`ROBISIE_REVIEW_KEY`); odbiór lokalnej karty przez drugiego aktora (`delivered` → `done`) jest chroniony. / `init` and `doctor` require the B acceptance key (`ROBISIE_REVIEW_KEY`); local card acceptance by a second actor (`delivered` → `done`) is protected.
10
+ - Cała paczka wymaga Node >=24; starszy Node otrzymuje polski komunikat odmowy przed `init`, `doctor` i `factory run`. / The entire package requires Node >=24; older Node versions receive a Polish refusal message before `init`, `doctor` and `factory run`.
11
+ - `prepack` i staging wydania dostarczają ten sam komplet plików; smoke wydania sprawdza ten sam tgz na Node 24 i odmowę na Node 22. / `prepack` and release staging provide the same complete file set; the release smoke test checks the same tgz on Node 24 and refusal on Node 22.
12
+ - Dokumentacja obejmuje README PL/EN, notę wydania i inwentarz paczki z silnikiem. / Documentation includes PL/EN READMEs, a release note and the package inventory with the engine.
13
+
14
+ Ograniczenia: automatyczne plany FJ u klienta „wkrótce”; silnik tylko na Linuxie; realny dowód u klienta w odbiorze D9. / Limits: automatic customer FJ plans “coming soon”; engine on Linux only; real customer evidence in D9 acceptance.
15
+
16
+ ## 0.1.4 (2026-11-04)
17
+
18
+ Wydanie poprawek dokumentacji. / Documentation patch release.
19
+
20
+ - Przewodniki PL/EN i README paczki opisują jednorazową zgodę agenta na nazwany przebieg (konto, klucz, init, pierwsza karta), oddzieloną od końcowego odbioru. / PL/EN guides and the package README describe the agent's one-time consent for a named run (account, key, init, first card), kept separate from final acceptance.
21
+ - Przewodniki wyjaśniają konfigurację ról: trzy role instalatora (`ceo`, `builder`, `quality`) z jednym dostawcą oraz ich odrębność od rejestru wykonania `roleRegistry`. / Guides explain role setup: three installer roles (`ceo`, `builder`, `quality`) with one provider and their separation from the `roleRegistry` execution registry.
22
+ - Ponowna instalacja: odmowa utworzenia istniejącego `package.json` podaje następny krok; aktualizacja przed pierwszym init (`npm i robisie@latest`, bez klucza) jest oddzielona od chronionej aktualizacji po init; polecenia kopii i przywracania przeniesiono z tabel do bloków bez zmiany ścieżek i kolejności. / Reinstallation: refusing to create an existing `package.json` names the next step; the pre-init update (`npm i robisie@latest`, keyless) is separated from the guarded post-init update; backup and restore commands moved from tables to code blocks without changing paths or order.
23
+ - Testy dokumentacji: nowy `docs-014` oraz dostosowane istniejące testy przewodników. / Documentation tests: new `docs-014` and adjusted existing guide tests.
24
+
3
25
  ## 0.1.3 (2026-11-04)
4
26
 
5
27
  Wydanie poprawek dokumentacji i pomocy CLI. / Documentation and CLI help patch release.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # robisie
2
2
 
3
- Przewodniki: [PL — konto → odbiór → odinstalowanie](docs/README.md) · [EN — account → acceptance → uninstall](docs/README.en.md). Przygotuj Node.js 20+, npm, program jednego dostawcy AI oraz pusty katalog; nie potrzebujesz strony ani własnego pliku `package.json` — utworzy go poniższy krok Node.js przed instalacją. Zacznij od konta i projektu w panelu. Projekt w panelu i katalog na dysku to osobne rzeczy; CEO wymaga dokładnie jednego projektu z discovery.
3
+ Przewodniki: [PL — konto → odbiór → odinstalowanie](docs/README.md) · [EN — account → acceptance → uninstall](docs/README.en.md). Przygotuj Node.js 24+ (wydanie użyte przy sprawdzeniach: 24.3.0), npm, program jednego dostawcy AI oraz pusty katalog; silnik w paczce (`dist/engine/tick.cjs`) wymaga systemu Linux. Nie potrzebujesz strony ani własnego pliku `package.json` — utworzy go poniższy krok Node.js przed instalacją. Zacznij od konta i projektu w panelu. Projekt w panelu i katalog na dysku to osobne rzeczy; CEO wymaga dokładnie jednego projektu z `list_projects`.
4
4
 
5
5
  Konto i klucz są potrzebne do init i pracy ról. Osobne wejście to walidacja offline, gdy CLI jest dostępne: nie sprawdza instalacji, nie uruchamia dostawców i nie wymaga podawania UUID projektu. Osobno `npx robisie doctor --engine-config ./robisie.config.json` sprawdza offline tylko strukturę: nie potwierdza UUID projektu, repo, modeli ani uruchomienia dostawców. Lokalne przewodniki są w `node_modules/robisie/docs/`.
6
6
 
@@ -14,32 +14,53 @@ Jeśli trasa przekierowała na /dashboard bez Planera, znajdź „Zacznij od pie
14
14
 
15
15
  ## Init — połącz agenta
16
16
 
17
- Agent może sam założyć konto i wygenerować klucz na własnym koncie, w granicach zgody jego właściciela. Logowanie lub inny chroniony krok może wymagać potwierdzenia człowieka; po nim kontynuuj. Cudza otwarta sesja nie uprawnia do korzystania z jej konta ani klucza. Sekret pozostaje poza rozmową i historią poleceń; jeśli dostępne narzędzia nie pozwalają przekazać go bezpiecznie, człowiek wpisuje go w ukrytym pytaniu init.
17
+ <!-- agent-consent:start -->
18
+ ### Instrukcja dla agenta — jedna zgoda na przebieg
18
19
 
19
- Jawnie wybierz `worker` w Connect; kolejne klucze mają domyślnie `observer`, który tylko czyta. Człowiek generuje klucz worker z etykietą w https://robisie.app/dashboard/connect i podaje go poza rozmową do ukrytego pytania init, nigdy do czatu, argumentu polecenia ani historii powłoki. W zsh/bash usuń stary ENV, a po udanym init wczytaj zapisany klucz do bieżącej powłoki bez wyświetlania go — init nie ustawia jej środowiska. Dla nowej instalacji z Claude wejdź do wybranego pustego katalogu (zastąp przykładową ścieżkę poniżej). Poniższy krok Node.js tworzy lokalny `package.json` niezależnie od nazwy katalogu, także ze spacjami i polskimi znakami. Manifest ustala katalog instalacji także pod przodkiem z `node_modules`. Jeśli ścieżka `package.json` już istnieje (również jako link), krok odmawia zapisu; niczego nie nadpisuje. EEXIST oznacza istniejącą ścieżkę: wybierz drogę istniejącego projektu poniżej; link/katalog wymaga wyjaśnienia. Błąd wejścia do katalogu lub utworzenia manifestu zatrzymuje dalszy blok:
20
+ Na początku poproś raz o zgodę na nazwany przebieg i jego granice: własne konto, wygenerowanie klucza, bezpieczny lokalny zapis klucza, init oraz pierwszą uzgodnioną kartę (cel, katalog, zakres zapisu i kryteria wyniku). Przykład pierwszej karty poniżej obejmuje tylko `wynik.txt`; wybierz ją z właścicielem przed prośbą o zgodę.
21
+
22
+ Jeśli właściciel już udzielił zgody na ten przebieg, nie pytaj ponownie przy tych krokach; kontynuuj w ustalonych granicach. Brak zgody, null, pusta lub niejasna odpowiedź albo zmiana zakresu wymagają pytania przed zależnym krokiem; wykonuj dalej niezależne dozwolone czynności. Odmowę uszanuj: nie wykonuj odmówionych kroków. Zgoda nie omija chronionych potwierdzeń człowieka ani dostawcy; po takim potwierdzeniu kontynuuj. Klucz pozostaje poza rozmową, kartą, argumentami i historią poleceń; gdy bezpieczny zapis lub przekazanie nie jest dostępne, człowiek używa ukrytego pytania init. Cudza otwarta sesja nie daje dostępu do jej konta. Po pracy nadal obowiązują niezależna recenzja oraz osobny końcowy odbiór wyniku przez właściciela.
23
+ <!-- agent-consent:end -->
24
+
25
+ Trzy role instalatora używają jednego dostawcy: CEO (`ceo`), Builder (`builder`), Quality Officer (`quality`). Mieszana mapa nie uruchamia ról między dostawcami, a doctor zwraca kod 1. Dla Claude użyj pełnego przypisania `npx robisie init --agent claude --role ceo=claude --role builder=claude --role quality=claude` zamiast linii init poniżej. Dla Codex/OpenCode zastąp każde `claude` przez `codex`/`opencode`; samo `--agent` nie kasuje wcześniejszej mapy.
26
+
27
+ Ustawienia instalatora `ceo`/`builder`/`quality` (CEO/Builder/Quality Officer) są odrębne od rejestru wykonania `roleRegistry`: `worker-client`, `lead-client`, `reviewer-client`, `tester-client`. Nazwy projektu `coordinator`/`owner`/`planner`/`advisor` to jeszcze inne ustawienie. Nie ma automatycznej konwersji między nimi; rejestr nie włącza mieszanego wykonywania ról instalatora.
28
+
29
+ Wymagane są dwa osobne klucze: A (`ROBISIE_KEY`, worker) i B (`ROBISIE_REVIEW_KEY`, owner_validator). W https://robisie.app/dashboard/connect wygeneruj NOWY klucz B z rolą `owner_validator` i etykietą inną niż A: powtórzenie etykiety A rotuje A. Etykieta nie ogranicza klucza do projektu. B podaj poza rozmową w osobnym ukrytym pytaniu init albo przez bezpiecznie przygotowane ENV; `--key-stdin` pobiera tylko A. ENV B ma pierwszeństwo przed zapisanym `review-key` i pytaniem; otaczające spacje są błędem. Reinstalacja używa zapisanego B, jeśli ENV jest puste. Niepusty wadliwy B wymaga naprawy, bez zastępowania innym źródłem.
30
+
31
+ A i B są zapisywane osobno w `${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key` i `review-key` (pliki 0600, katalog 0700). B nie trafia do konfiguracji agentów/modeli, manifestu, argumentów, claimów ani komunikatów. Załaduj oba ENV także przy `--no-shell`. Przed pierwszym zadaniem uruchom zwykły `npx robisie doctor`: tryb `--engine-config` nie sprawdza kluczy. Przy brakującym lub niepoprawnym A doctor diagnozuje A; sprawdzanie B zaczyna dopiero, gdy A jest obecny i ma poprawny format. Brak B, B=A, zły format i nieudany odczyt B dają exit 1. B sprawdzane jest przez `initialize` + `list_projects`, bez mutacji danych biznesowych; liczniki auth mogą wzrosnąć. Odczyt nie potwierdza roli, wspólnego konta A/B ani polityki projektu.
32
+
33
+ Każdy wynik doctor zawiera `! Polityka enforced: NIE SPRAWDZONO — klient nie ma API jej odczytu.` Odmowa kontekstu projektu następuje przed doctor i ma własną poradę. Zielony doctor nie oznacza aktywacji enforced. Przy błędzie B sprawdź dostęp do Connect i wystawienie owner_validator; awaria sieci nie dowodzi unieważnienia. Ponów init z poprawnym B w ENV, potem doctor. Zmiana polityki wymaga osobnej uprawnionej czynności operatora.
34
+
35
+ Jawnie wybierz `worker` w Connect; kolejne klucze mają domyślnie `observer`, który tylko czyta. Człowiek generuje klucz worker z etykietą w https://robisie.app/dashboard/connect i podaje go poza rozmową do ukrytego pytania init, nigdy do czatu, argumentu polecenia ani historii powłoki. W zsh/bash usuń stary ENV, a po udanym init wczytaj zapisany klucz do bieżącej powłoki bez wyświetlania go — init nie ustawia jej środowiska. Dla nowej instalacji z Claude wejdź do wybranego pustego katalogu (zastąp przykładową ścieżkę poniżej). Poniższy krok Node.js tworzy lokalny `package.json` niezależnie od nazwy katalogu, także ze spacjami i polskimi znakami. Manifest ustala katalog instalacji także pod przodkiem z `node_modules`. Jeśli ścieżka `package.json` już istnieje (również jako link), krok odmawia zapisu; niczego nie nadpisuje. Błąd wejścia do katalogu lub utworzenia manifestu zatrzymuje dalszy blok:
20
36
 
21
37
  ```sh
22
38
  cd "/ścieżka/do/pustego katalogu" &&
23
39
  node -e 'try {
24
40
  require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
25
41
  } catch (error) {
26
- console.error(error.message);
42
+ console.error("Nie można utworzyć package.json: ścieżka już istnieje albo jest niedostępna. Następny krok: zachowaj ją i przejdź do instrukcji istniejącego projektu/reinstalacji poniżej; link/katalog lub błąd dostępu wyjaśnij lokalnie przed ponowieniem.");
27
43
  process.exit(1);
28
44
  }' &&
29
45
  {
30
46
  set +x
31
47
  npm i robisie &&
32
- unset ROBISIE_KEY &&
48
+ unset ROBISIE_KEY ROBISIE_REVIEW_KEY &&
33
49
  npx robisie init --agent claude &&
34
50
  {
35
51
  if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
36
52
  [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
37
53
  [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
54
+ [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
55
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
56
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
57
+ ROBISIE_REVIEW_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" 2>/dev/null)" &&
58
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
38
59
  ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
39
60
  [ -n "$ROBISIE_KEY" ]; then
40
- export ROBISIE_KEY
61
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
41
62
  else
42
- printf '%s\n' 'Nie można wczytać niepustego, zwykłego, czytelnego pliku klucza robisie.' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub unieważnieniu klucza wróć do Connect i init z ukrytym pytaniem. Nie wklejaj klucza do rozmowy.' >&2
63
+ printf '%s\n' 'Nie można wczytać obu niepustych, zwykłych, czytelnych plików kluczy robisie (key, review-key).' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub odmowie B podaj nowy owner_validator przez ROBISIE_REVIEW_KEY do init; --key-stdin wymienia tylko A. Nie wklejaj klucza do rozmowy.' >&2
43
64
  false
44
65
  fi
45
66
  } &&
@@ -49,7 +70,7 @@ npx robisie doctor
49
70
 
50
71
  Ł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.
51
72
 
52
- Dla istniejącego projektu bez `package.json` wykonaj powyższy blok nowej instalacji w katalogu tego projektu: tworzy tylko prywatny manifest i zachowuje pozostałe pliki. Jeśli zwykły manifest już istnieje albo reinstalujesz z zachowanym poprawnym kluczem, użyj poniższego bloku w wybranym katalogu projektu. Wczytuje zapisany klucz przed npm/init/doctor, nie nadpisuje zwykłego manifestu podczas przygotowania i tworzy go przez `wx` tylko przy braku. Samo npm może następnie dopisać zależność robisie oraz zmienić lockfile. Link manifestu (także wiszący) lub katalog odrzuca z wyjaśnieniem. Po uninstall, gdy nie ma poprawnego klucza, wróć do Connect i ukrytego pytania init: przy istniejącym zwykłym manifeście wykonaj blok nowej instalacji od `set +x` do doctor, bez kroku `cd`/tworzenia manifestu. Nie usuwaj manifestu, żeby ponowić instalację.
73
+ Dla istniejącego projektu bez `package.json` wykonaj powyższy blok nowej instalacji w katalogu tego projektu: tworzy tylko prywatny manifest i zachowuje pozostałe pliki. Jeśli zwykły manifest już istnieje albo reinstalujesz z zachowanym poprawnym kluczem, użyj poniższego bloku w wybranym katalogu projektu. Wczytuje zapisany klucz przed npm/init/doctor, nie nadpisuje zwykłego manifestu podczas przygotowania i tworzy go przez `wx` tylko przy braku. Samo npm może następnie dopisać zależność robisie oraz zmienić lockfile. Link manifestu (także wiszący) lub katalog odrzuca z wyjaśnieniem. Po uninstall zachowaj pozostawiony `package.json`. Gdy nie ma poprawnego klucza, wróć do Connect i ukrytego pytania init: przy istniejącym zwykłym manifeście wykonaj blok nowej instalacji od `set +x` do doctor, bez kroku `cd`/tworzenia manifestu. Nie usuwaj manifestu, żeby ponowić instalację.
53
74
 
54
75
  <!-- reinstall:start -->
55
76
  ```sh
@@ -58,11 +79,16 @@ set +x
58
79
  if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
59
80
  [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
60
81
  [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
82
+ [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
83
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
84
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
85
+ ROBISIE_REVIEW_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" 2>/dev/null)" &&
86
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
61
87
  ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
62
88
  [ -n "$ROBISIE_KEY" ]; then
63
- export ROBISIE_KEY
89
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
64
90
  else
65
- printf '%s\n' 'Nie można wczytać niepustego, zwykłego, czytelnego pliku klucza robisie.' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub unieważnieniu klucza wróć do Connect i init z ukrytym pytaniem. Nie wklejaj klucza do rozmowy.' >&2
91
+ printf '%s\n' 'Nie można wczytać obu niepustych, zwykłych, czytelnych plików kluczy robisie (key, review-key).' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub odmowie B podaj nowy owner_validator przez ROBISIE_REVIEW_KEY do init; --key-stdin wymienia tylko A. Nie wklejaj klucza do rozmowy.' >&2
66
92
  false
67
93
  fi
68
94
  } &&
@@ -89,16 +115,18 @@ Dla Codex lub OpenCode zastąp `claude` przez `codex` lub `opencode`. Sam `--age
89
115
 
90
116
  ## Po init — sprawdź gotowość CEO
91
117
 
92
- 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.
118
+ Po Connect, init i wczytaniu klucza według bloku powyżej uruchom `npx robisie doctor`. Odczyt projektów to odczyt aktywnych projektów przez `list_projects`. Nie wymaga wpisywania UUID. Sam `init` z exit 0 ani „połączono” nie wystarczają do potwierdzenia gotowości CEO.
93
119
 
94
120
  - **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.
95
- - **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.
121
+ - **Więcej niż 1 projekt, exit 1** (np. `CEO wymaga dokładnie 1 projektu (projektów: 2).`): Uporządkuj widoczność projektów w `list_projects` do 1; sam wybór projektu w panelu nie zmienia wyniku `list_projects`. Człowiek sam decyduje, który projekt zachować aktywny; przy pozostałych na liście wybiera „Archiwizuj”. „Archiwum” → „Przywróć” cofa archiwizację. Nie usuwaj projektów. Kliknięcie projektu nie zawęża wyniku `list_projects`.
96
122
  - **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.
97
123
 
98
124
  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.
99
125
 
100
126
  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.
101
127
 
128
+ Przykład pierwszej karty: w katalogu instalacji utwórz tylko `wynik.txt` z treścią „robisie działa” i końcowym znakiem nowej linii; sprawdź dokładną treść odczytem, bez zależności i publikacji.
129
+
102
130
  ## Start CEO
103
131
 
104
132
  Człowiek uruchamia CEO w katalogu instalacji.
@@ -113,30 +141,54 @@ W Claude Code CEO uruchamia niezależnego Quality Officera przez `Agent(quality-
113
141
 
114
142
  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.
115
143
 
116
- 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.
144
+ Codex: przejście do delivered wymaga niezależnej recenzji oraz zweryfikowanego potwierdzenia (verified receipt). Jeśli w sesji CEO brakuje narzędzia Agent, karta pozostaje w `in_review` i wymaga naprawy integracji przez osobę odpowiedzialną za integrację CEO.
117
145
 
118
146
  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.
119
147
 
120
- 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:
148
+ ### Aktualizacja przed pierwszym init
149
+
150
+ W przygotowanym katalogu instalacji, przed pierwszym init, aktualizacja samej paczki npm nie wymaga klucza ani `manifest.json` instalatora. Zachowaj istniejący manifest projektu; w pustym katalogu utwórz najpierw lokalny `package.json` samym krokiem Node powyżej. Następnie wykonaj jedną linię; do wybranego przepisu init przejdź, gdy konto i klucz będą gotowe.
151
+
152
+ <!-- before-init-update:start -->
153
+ ```sh
154
+ npm i robisie@latest
155
+ ```
156
+ <!-- before-init-update:end -->
157
+
158
+ ### Aktualizacja po init
159
+
160
+ Aktualizuj w katalogu instalacji po prywatnej kopii opisanej w przewodnikach, z tym samym XDG_CONFIG_HOME i CODEX_HOME. `npx robisie init` odświeża zapisanych agentów i mapę ról, używając poprawnego zapisanego klucza bez ponownego wpisywania. ROBISIE_KEY ma pierwszeństwo; jawny `--key-stdin` zachowuje tor pytania/stdin i umożliwia wymianę klucza. Bez zapisanej instalacji lub przy braku/pustym kluczu init korzysta z dotychczasowego pytania. Wadliwy niepusty klucz, błąd odczytu lub dowiązanie wymagają naprawy lokalnej, bez nadpisywania.
161
+
162
+ Doctor podaje rzeczywiste wersje starych pomocników i markerów ról oraz wersję paczki; wskazane init aktualizuje je przez zwykły zapis z kopiami. Doctor i agenci nadal wymagają ROBISIE_KEY w środowisku. Poniższy przykład usuwa wcześniejszy ROBISIE_KEY z sesji, aby init użył zapisanego pliku; po init wczytuje ENV dla doctor i agentów, bez xtrace i bez wydruku:
163
+
164
+ Kopia i odtworzenie obejmują oba pliki key i review-key z prywatnymi uprawnieniami; przed init/doctor wczytaj oba odtworzone klucze. Uninstall raportuje osobno stan obu plików i usuwa je z zachowaniem dotychczasowej ochrony ewidencji oraz konfiguracji. Nie unieważnia żadnego klucza na serwerze.
121
165
 
166
+ <!-- update:start -->
122
167
  ```sh
123
168
  set +x
169
+ unset ROBISIE_KEY ROBISIE_REVIEW_KEY &&
170
+ npm i robisie@latest &&
171
+ npx robisie init &&
124
172
  {
125
173
  if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
126
174
  [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
127
175
  [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
176
+ [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
177
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
178
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
179
+ ROBISIE_REVIEW_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" 2>/dev/null)" &&
180
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
128
181
  ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
129
182
  [ -n "$ROBISIE_KEY" ]; then
130
- export ROBISIE_KEY
183
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
131
184
  else
132
- printf '%s\n' 'Nie można wczytać niepustego, zwykłego, czytelnego pliku klucza robisie.' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub unieważnieniu klucza wróć do Connect i init z ukrytym pytaniem. Nie wklejaj klucza do rozmowy.' >&2
185
+ printf '%s\n' 'Nie można wczytać obu niepustych, zwykłych, czytelnych plików kluczy robisie (key, review-key).' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub odmowie B podaj nowy owner_validator przez ROBISIE_REVIEW_KEY do init; --key-stdin wymienia tylko A. Nie wklejaj klucza do rozmowy.' >&2
133
186
  false
134
187
  fi
135
188
  } &&
136
- npm i robisie@latest &&
137
- npx robisie init &&
138
189
  npx robisie doctor
139
190
  ```
191
+ <!-- update:end -->
140
192
 
141
193
  Doctor sprawdza MAJOR kontraktu. Przy niezgodności wybierz zgodne wydanie. Poprzedni zgodny tgz przygotuj przez `npm pack robisie@<wersja>`; komenda powrotu `npm i --no-save "$backup/robisie-$previous_version.tgz"` wymaga jawnie wybranej wersji, prywatnej kopii konfiguracji i porównania późniejszych własnych zmian według przewodników. Opcja `--no-save` zachowuje przywrócone `package.json` i `package-lock.json`, bez zapisywania zależności `file:` od ścieżki prywatnej kopii. Kolejność powrotu: konfiguracja i OBA manifesty projektu (`package.json`, `package-lock.json`) → ENV starego klucza → tgz → init → doctor. To nie jest automatyczny rollback.
142
194
 
@@ -175,6 +227,8 @@ Uruchom `npx robisie doctor --engine-config ./robisie.config.json` (także `--en
175
227
 
176
228
  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.
177
229
 
230
+ Silnik paczki — `dist/engine/tick.cjs` — jest odrębny od instalatora: `init`/`doctor`/`uninstall` go nie uruchamiają. Uruchamia go `npx robisie factory run --engine-config ./robisie.config.json` (flaga `--once` wykonuje jeden takt) i tylko na Linuxie z Node.js 24+; starszy Node, np. 22, otrzymuje odmowę przed `init`, `doctor` i `factory run`, a na innym systemie niż Linux polecenie odmawia z kodem 2 i komunikatem. Pełny opis pól konfiguracji: `node_modules/robisie/docs/ENGINE-CONFIG.md`. Każdy niezerowy wynik taktu zatrzymuje nadzorcę („Fabryka zatrzymana: …”) z jedną linią diagnozy na stderr; kod 2 to eskalacja (np. brak klucza B po receiver PASS, odmowa testera, STOP odbioru) wymagająca rozstrzygnięcia przed ponowieniem, a kod 78 wskazuje konfigurację do poprawy.
231
+
178
232
  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.
179
233
 
180
- Backupy po uninstall mogą nadal zawierać klucz; zachowaj ich prywatność i własną retencję, bez automatycznego kasowania. Wpis CHANGELOG o readback README nie dowodzi niepustego README w rejestrze: E4 wykazał 0 B przy poprawnym tarballu. Użyj lokalnych przewodników w `node_modules/robisie/docs/`; naprawa rejestru i publikacja to osobny zakres wydania.
234
+ Backupy po uninstall mogą nadal zawierać klucz; zachowaj ich prywatność i własną retencję, bez automatycznego kasowania. Jeśli README w rejestrze jest puste, użyj lokalnych przewodników w `node_modules/robisie/docs/`; naprawa rejestru i publikacja to osobny zakres wydania.
package/dist/agents.d.ts CHANGED
@@ -31,4 +31,4 @@ export declare function removeCodexTables(text: string, removeInline?: boolean,
31
31
  export declare function planAgent(ctx: Ctx, id: AgentId, roles: readonly Role[], key: string): Op[];
32
32
  /** Shell profile line that exports ROBISIE_KEY from the package's key file (roles and Codex/OpenCode read it). */
33
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\")\"";
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\")\"\n[ -r \"${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key\" ] && export ROBISIE_REVIEW_KEY=\"$(cat \"${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key\")\"";
package/dist/agents.js CHANGED
@@ -243,4 +243,4 @@ export function shellProfile(ctx) {
243
243
  return null;
244
244
  }
245
245
  const SHELL_KEY_PATH = '"${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key"';
246
- export const SHELL_EXPORT = `[ -r ${SHELL_KEY_PATH} ] && export ${KEY_ENV}="$(cat ${SHELL_KEY_PATH})"`;
246
+ export const SHELL_EXPORT = `[ -r ${SHELL_KEY_PATH} ] && export ${KEY_ENV}="$(cat ${SHELL_KEY_PATH})"\n[ -r "\${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] && export ROBISIE_REVIEW_KEY="$(cat "\${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key")"`;
@@ -1,6 +1,6 @@
1
1
  export function failedTestFiles(raw) {
2
2
  const clean = raw.replace(/\x1b\[[0-9;]*[A-Za-z]/g, "");
3
- return [...new Set(Array.from(clean.matchAll(/(?:^|[\t ])FAIL[\t ]+([^\s]+\.test\.(?:ts|tsx|mts|mjs|js))[\t ]+(?:>|\[)/gm), match => match[1]))];
3
+ return [...new Set(Array.from(clean.matchAll(/^(?:[^\t\r\n]*\t[^\t\r\n]*\t)?(?:\d{4}-\d{2}-\d{2}T[\d:.]+Z[\t ]+)?[\t ]*FAIL[\t ]+([^\s]+\.test\.(?:ts|tsx|mts|mjs|js))[\t ]+(?:>|\[)/gm), match => match[1]))];
4
4
  }
5
5
  export function normalizeCiLogTail(raw, maxLines = 40, maxChars = 1000) {
6
6
  const lines = raw.split(/\r?\n/).map((line) => line
package/dist/cli.d.ts CHANGED
@@ -12,6 +12,8 @@ export interface ParsedArgs {
12
12
  shell: boolean;
13
13
  keyStdin: boolean;
14
14
  engineConfig: string | null;
15
+ interval: number;
16
+ once: boolean;
15
17
  }
16
18
  export declare function parseArgs(argv: readonly string[]): ParsedArgs;
17
19
  export declare function run(argv: readonly string[], ctx: Ctx): Promise<number>;
package/dist/cli.js CHANGED
@@ -5,17 +5,26 @@ import { AGENT_IDS, isAgentId } from "./agents.js";
5
5
  import { doctor, init, recoveryStep, uninstall } from "./commands.js";
6
6
  import { HELPER_SERVERS, PACKAGE_VERSION } from "./constants.js";
7
7
  import { RobisieError, errorMessage, nodeCtx } from "./context.js";
8
+ import { runFactory } from "./factory-run.js";
8
9
  import { isHelperServer, runHelper } from "./helpers.js";
9
10
  import { ROLE_IDS, ROLE_STEP } from "./manifest.js";
10
11
  import { doctorEngineConfig } from "./role-registry.js";
11
12
  const HELP = `robisie ${PACKAGE_VERSION} — łączy Twojego agenta z tablicą robisie
12
13
 
13
- npx robisie init klucz rob_… (z ${"ROBISIE_KEY"} albo z pytania) + konfiguracja MCP + role klienta
14
- npx robisie doctor sprawdza połączenie, wersję kontraktu i role
14
+ npx robisie init klucze A (ROBISIE_KEY) i B (ROBISIE_REVIEW_KEY), osobne ukryte pytania + konfiguracja MCP + role klienta
15
+ npx robisie doctor sprawdza A i B, wersję kontraktu i role; enforced: NIE SPRAWDZONO
15
16
  npx robisie uninstall usuwa wpisy robisie i role; zachowuje kopie zapasowe
17
+ npx robisie factory run nadzoruje kolejne takty silnika (Linux, Node.js >=24)
16
18
  npx robisie mcp <${HELPER_SERVERS.join("|")}>
17
19
  pomocnik ról (serwer MCP stdio) — uruchamia go agent, nie Ty
18
20
 
21
+ Opcje factory run:
22
+ --engine-config <path> plik konfiguracji; flaga wygrywa z ROBISIE_ENGINE_CONFIG
23
+ --engine-config=<path> profil engine.delivery: local, stateDir poza repo
24
+ --interval <sekundy> przerwa po zakończeniu taktu: 1–86400, domyślnie 120; także --interval=120
25
+ --once jeden takt bez przerwy; wyklucza jawne --interval
26
+ Ctrl+C zatrzymuje nadzorcę i grupę taktu; odłączone joby mogą działać dalej.
27
+
19
28
  Opcje doctor:
20
29
  --engine-config <path> offline sprawdza strukturę konfiguracji projektu i przypisania czterech ról wykonania
21
30
  --engine-config=<path> ta sama składnia; nie sprawdza uruchomienia dostawców
@@ -28,8 +37,8 @@ Opcje init:
28
37
  --agent <${AGENT_IDS.join("|")}> wybrany dostawca (można powtórzyć albo podać po przecinku); razem z dostawcami mapy, bez --agent również wykryci
29
38
  --role <rola=dostawca> wybór ceo, builder, quality → claude, codex, opencode (można powtórzyć)
30
39
  --role=rola=dostawca ta sama składnia; np. --role=builder=codex zachowuje resztę mapy
31
- --no-shell nie dopisuj ROBISIE_KEY do profilu powłoki
32
- --key-stdin weź klucz z wejścia standardowego (np. printenv KLUCZ | npx robisie init --key-stdin)
40
+ --no-shell nie dopisuj ROBISIE_KEY i ROBISIE_REVIEW_KEY do profilu powłoki
41
+ --key-stdin weź tylko klucz A z wejścia standardowego (np. printenv KLUCZ | npx robisie init --key-stdin)
33
42
  `;
34
43
  export function parseArgs(argv) {
35
44
  const args = [...argv];
@@ -40,9 +49,17 @@ export function parseArgs(argv) {
40
49
  let keyStdin = false;
41
50
  let engineConfig = null;
42
51
  let target = null;
52
+ let interval = 120;
53
+ let intervalSet = false;
54
+ let once = false;
43
55
  // Help wins over everything else, so `init --help` never starts an install.
44
56
  if (argv.includes("--help") || argv.includes("-h"))
45
- return { command, help: true, target, agents: null, roles, shell, keyStdin, engineConfig };
57
+ return { command, help: true, target, agents: null, roles, shell, keyStdin, engineConfig, interval, once };
58
+ if (command === "factory") {
59
+ target = args.shift() ?? null;
60
+ if (target !== "run")
61
+ throw new RobisieError("Polecenie factory wymaga podkomendy run.", "Zobacz `npx robisie help`.");
62
+ }
46
63
  while (args.length > 0) {
47
64
  const arg = args.shift();
48
65
  if (command !== "init" && (arg === "--no-shell" || arg === "--key-stdin" ||
@@ -52,8 +69,8 @@ export function parseArgs(argv) {
52
69
  }
53
70
  if (arg === "--engine-config" || arg.startsWith("--engine-config=")) {
54
71
  const step = "Użyj `npx robisie doctor --engine-config <path>` z jedną niepustą ścieżką pliku.";
55
- if (command !== "doctor")
56
- throw new RobisieError("Opcja --engine-config jest dostępna tylko dla polecenia doctor.", step);
72
+ if (command !== "doctor" && command !== "factory")
73
+ throw new RobisieError("Opcja --engine-config jest dostępna tylko dla poleceń doctor i factory run.", step);
57
74
  if (engineConfig !== null)
58
75
  throw new RobisieError("Opcję --engine-config można podać tylko raz.", step);
59
76
  const value = arg === "--engine-config" ? args.shift() ?? "" : arg.slice("--engine-config=".length);
@@ -61,6 +78,19 @@ export function parseArgs(argv) {
61
78
  throw new RobisieError("Opcja --engine-config wymaga ścieżki pliku.", step);
62
79
  engineConfig = value;
63
80
  }
81
+ else if (command === "factory" && (arg === "--interval" || arg.startsWith("--interval="))) {
82
+ const value = arg === "--interval" ? args.shift() ?? "" : arg.slice("--interval=".length);
83
+ if (intervalSet || !/^\d+$/.test(value) || Number(value) < 1 || Number(value) > 86400) {
84
+ throw new RobisieError("Opcja --interval wymaga jednej liczby całkowitej 1–86400.", "Zobacz `npx robisie help`.");
85
+ }
86
+ interval = Number(value);
87
+ intervalSet = true;
88
+ }
89
+ else if (command === "factory" && arg === "--once") {
90
+ if (once)
91
+ throw new RobisieError("Opcję --once można podać tylko raz.", "Zobacz `npx robisie help`.");
92
+ once = true;
93
+ }
64
94
  else if (arg === "--no-shell")
65
95
  shell = false;
66
96
  else if (arg === "--key-stdin")
@@ -98,10 +128,15 @@ export function parseArgs(argv) {
98
128
  else
99
129
  throw new RobisieError("Nieznana opcja argumentów CLI.", "Zobacz `npx robisie help`.");
100
130
  }
101
- return { command, help: false, target, agents: agents.length > 0 ? agents : null, roles, shell, keyStdin, engineConfig };
131
+ if (once && intervalSet)
132
+ throw new RobisieError("Opcje --once i --interval wykluczają się.", "Zobacz `npx robisie help`.");
133
+ return { command, help: false, target, agents: agents.length > 0 ? agents : null, roles, shell, keyStdin, engineConfig, interval, once };
102
134
  }
103
135
  export async function run(argv, ctx) {
104
136
  try {
137
+ if (Number(process.versions.node.split(".")[0]) < 24) {
138
+ throw new RobisieError("Polecenia robisie wymagają Node.js >=24.", "Zainstaluj Node.js 24 lub nowszy i ponów polecenie.");
139
+ }
105
140
  const args = parseArgs(argv);
106
141
  if (args.help) {
107
142
  ctx.out(HELP);
@@ -133,6 +168,8 @@ export async function run(argv, ctx) {
133
168
  return await doctor(ctx);
134
169
  case "uninstall":
135
170
  return uninstall(ctx);
171
+ case "factory":
172
+ return await runFactory(ctx, { engineConfig: args.engineConfig, interval: args.interval, once: args.once });
136
173
  case "mcp":
137
174
  if (!args.target || !isHelperServer(args.target)) {
138
175
  throw new RobisieError("Nieznany pomocnik (mcp).", `Użyj jednego z: ${HELPER_SERVERS.join(", ")}.`);
@@ -0,0 +1,9 @@
1
+ import { type Stats } from "node:fs";
2
+ type CodexEnvIo = {
3
+ realpathSync: (path: string) => string;
4
+ geteuid: () => number;
5
+ lstatSync: (path: string) => Pick<Stats, "uid" | "mode" | "isDirectory" | "isSymbolicLink">;
6
+ accessSync: (path: string, mode: number) => void;
7
+ };
8
+ export declare function assertCodexEnvironment(provider: string, platform: NodeJS.Platform, io?: CodexEnvIo): void;
9
+ export {};
@@ -0,0 +1,60 @@
1
+ import { accessSync, constants, lstatSync, realpathSync } from "node:fs";
2
+ import { isAbsolute, join } from "node:path";
3
+ import { RobisieError } from "./context.js";
4
+ const nodeIo = {
5
+ realpathSync, lstatSync, accessSync,
6
+ geteuid: () => {
7
+ if (!process.geteuid)
8
+ throw new Error("Effective uid unavailable");
9
+ return process.geteuid();
10
+ },
11
+ };
12
+ // Read-only preflight: codex-rs/uds/src/daemon_directory.rs at 49305d74b4c0048ee44702e3dd058e08ad3b4a51.
13
+ // Source SHA-256: fd1eae1b3292f4fbc98e482a392d16246baa7fac4593dd7c1818a481fed070d6. OK is subject to TOCTOU.
14
+ export function assertCodexEnvironment(provider, platform, io = nodeIo) {
15
+ if (provider !== "codex" || platform === "win32")
16
+ return;
17
+ let directory = "/tmp/codex-daemon-<UID>";
18
+ const reject = (reason, repair) => {
19
+ const nextStep = `${repair} Potem uruchom \`npx robisie doctor\`.`;
20
+ throw new RobisieError(`Codex nie wystartuje: ${directory} — ${reason}. ${nextStep}`, nextStep);
21
+ };
22
+ try {
23
+ const root = io.realpathSync("/tmp");
24
+ if (!isAbsolute(root))
25
+ throw new Error("Invalid canonical temporary root");
26
+ directory = join(root, "codex-daemon-<UID>");
27
+ const uid = io.geteuid();
28
+ if (!Number.isInteger(uid) || uid < 0)
29
+ throw new Error("Invalid effective uid");
30
+ directory = join(root, `codex-daemon-${uid}`);
31
+ let metadata;
32
+ try {
33
+ metadata = io.lstatSync(directory);
34
+ }
35
+ catch (error) {
36
+ if (error?.code !== "ENOENT")
37
+ throw error;
38
+ io.accessSync(root, constants.W_OK | constants.X_OK);
39
+ return;
40
+ }
41
+ if (!metadata.isDirectory() || metadata.isSymbolicLink() || metadata.uid !== uid
42
+ || !Number.isInteger(metadata.mode) || metadata.mode < 0) {
43
+ reject("konflikt właściciela, typu lub metadanych katalogu", `Poproś administratora o rozwiązanie konfliktu pod ${directory}; nie zmieniaj obcego pliku ani dowiązania automatycznie.`);
44
+ }
45
+ if ((metadata.mode & 0o777) !== 0o700) {
46
+ reject("własny katalog ma tryb inny niż 0700", `Sprawdź własny katalog ${directory} i po potwierdzeniu ustaw mu tryb 0700.`);
47
+ }
48
+ io.accessSync(directory, constants.W_OK | constants.X_OK);
49
+ }
50
+ catch (error) {
51
+ if (error instanceof RobisieError)
52
+ throw error;
53
+ const code = error?.code;
54
+ if (code === "EROFS")
55
+ reject("system plików tylko do odczytu", `Poproś administratora o zapisywalny mount dla ${directory}; sam chmod nie wystarczy.`);
56
+ if (code === "EACCES" || code === "EPERM")
57
+ reject("brak praw do katalogu lub jego rodzica", `Poproś administratora o sprawdzenie właściciela oraz nadanie praw zapisu i przejścia dla ${directory} lub jego rodzica.`);
58
+ reject("nie mogę zweryfikować katalogu (błąd odczytu lub metadanych)", `Poproś administratora o sprawdzenie ${directory}, jego rodzica i błędów systemu plików.`);
59
+ }
60
+ }