robisie 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,23 @@
1
1
  # Historia zmian klienta / Client changelog
2
2
 
3
+ ## 0.1.3 (2026-11-04)
4
+
5
+ Wydanie poprawek dokumentacji i pomocy CLI. / Documentation and CLI help patch release.
6
+
7
+ - Przewodniki pierwszej instalacji PL/EN po zimnym teście E4 wyjaśniają wybór klucza worker, ponowną instalację z zachowaniem manifestu oraz wczytanie klucza przed przywróceniem tgz. / Following the E4 cold test, PL/EN first-install guides clarify worker key selection, reinstallation preserving the manifest and key loading before tgz restore.
8
+ - Pomoc `doctor --engine-config` opisuje kontrolę offline struktury konfiguracji i przypisań ról wykonania, jej ograniczenia oraz ścieżki do lokalnych przewodników. / Help for `doctor --engine-config` describes offline checks of configuration structure and execution role assignments, their limits and paths to local guides.
9
+ - Testy dokumentacji wykonują polecenia instalacji, aktualizacji i przywracania, sprawdzając błędne pliki klucza, ochronę manifestów i brak ujawnienia klucza; test pomocy CLI sprawdza opis walidacji offline. / Documentation tests execute install, update and restore commands, checking invalid key files, manifest preservation and absence of key disclosure; a CLI help test checks the offline validation description.
10
+
11
+ ## 0.1.2 (2026-11-03)
12
+
13
+ Wydanie poprawek klienta i dokumentacji. / Client and documentation patch release.
14
+
15
+ - 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).
16
+ - 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.
17
+ - 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.
18
+ - 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.
19
+ - 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.
20
+
3
21
  ## 0.1.1 (2026-10-30)
4
22
 
5
23
  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.
package/README.md CHANGED
@@ -1,6 +1,8 @@
1
- # robisie 0.1.0
1
+ # robisie
2
2
 
3
- Przewodniki: [PL — konto → odbiór → odinstalowanie](https://unpkg.com/robisie/docs/README.md) · [EN — account → acceptance → uninstall](https://unpkg.com/robisie/docs/README.en.md). Przygotuj Node.js 20+, npm, program jednego dostawcy AI oraz pusty katalog; strona i package.json nie są potrzebne. 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 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
+
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/`.
4
6
 
5
7
  ## Przed init — konto i pierwszy projekt
6
8
 
@@ -12,15 +14,76 @@ Jeśli trasa przekierowała na /dashboard bez Planera, znajdź „Zacznij od pie
12
14
 
13
15
  ## Init — połącz agenta
14
16
 
15
- 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:
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.
18
+
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
+
21
+ ```sh
22
+ cd "/ścieżka/do/pustego katalogu" &&
23
+ node -e 'try {
24
+ require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
25
+ } catch (error) {
26
+ console.error(error.message);
27
+ process.exit(1);
28
+ }' &&
29
+ {
30
+ set +x
31
+ npm i robisie &&
32
+ unset ROBISIE_KEY &&
33
+ npx robisie init --agent claude &&
34
+ {
35
+ if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
36
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
37
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
38
+ ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
39
+ [ -n "$ROBISIE_KEY" ]; then
40
+ export ROBISIE_KEY
41
+ 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
43
+ false
44
+ fi
45
+ } &&
46
+ npx robisie doctor
47
+ }
48
+ ```
49
+
50
+ Ł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.
16
51
 
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ę.
53
+
54
+ <!-- reinstall:start -->
17
55
  ```sh
18
- npm i robisie
19
- unset ROBISIE_KEY
20
- npx robisie init --agent claude
21
- [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] && export ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key")"
56
+ set +x
57
+ {
58
+ if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
59
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
60
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
61
+ ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
62
+ [ -n "$ROBISIE_KEY" ]; then
63
+ export ROBISIE_KEY
64
+ 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
66
+ false
67
+ fi
68
+ } &&
69
+ node -e 'try {
70
+ const fs = require("node:fs");
71
+ let existing;
72
+ try { existing = fs.lstatSync("package.json"); }
73
+ catch (error) { if (error.code !== "ENOENT") throw error; }
74
+ if (existing) {
75
+ if (!existing.isFile()) throw new Error("package.json: wymagany zwykły plik; link i katalog odrzucone");
76
+ } else fs.writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
77
+ } catch (error) {
78
+ console.error(error.message);
79
+ console.error("Następny krok: sprawdź lokalnie package.json; zachowaj plik i wyjaśnij ścieżkę przed ponowieniem.");
80
+ process.exit(1);
81
+ }' &&
82
+ npm i robisie &&
83
+ npx robisie init &&
22
84
  npx robisie doctor
23
85
  ```
86
+ <!-- reinstall:end -->
24
87
 
25
88
  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.
26
89
 
@@ -54,11 +117,34 @@ Codex: przejście do delivered wymaga niezależnej recenzji oraz zweryfikowanego
54
117
 
55
118
  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.
56
119
 
57
- Aktualizuj w katalogu instalacji: `npm i robisie@latest` → `npx robisie init` → `npx robisie doctor`. Doctor sprawdza zgodność MAJOR kontraktu serwera; przy niezgodności wybierz zgodne wydanie. Awaryjnie otrzymany plik zainstaluj przez `npm i ./robisie-0.1.0.tgz`; lokalny powrót wymaga poprzedniego zgodnego tgz i kopii konfiguracji. Pełne instrukcje aktualizacji, powrotu i odinstalowania są w przewodnikach.
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:
121
+
122
+ ```sh
123
+ set +x
124
+ {
125
+ if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
126
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
127
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
128
+ ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
129
+ [ -n "$ROBISIE_KEY" ]; then
130
+ export ROBISIE_KEY
131
+ 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
133
+ false
134
+ fi
135
+ } &&
136
+ npm i robisie@latest &&
137
+ npx robisie init &&
138
+ npx robisie doctor
139
+ ```
140
+
141
+ 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.
58
142
 
59
- ## Lokalna walidacja rejestru wykonania K7
143
+ 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.
60
144
 
61
- Zapisz pełną konfigurację K2 i osobny rejestr wykonania w `robisie.config.json`:
145
+ ## Lokalna walidacja konfiguracji wykonania
146
+
147
+ Zapisz konfigurację projektu i osobny rejestr wykonania w `robisie.config.json`:
62
148
 
63
149
  ```json
64
150
  {
@@ -85,8 +171,10 @@ Zapisz pełną konfigurację K2 i osobny rejestr wykonania w `robisie.config.jso
85
171
  }
86
172
  ```
87
173
 
88
- 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 K2 `coordinator/owner/planner/advisor` zachowują domyślne nazwy; opcjonalne pole `roles` służy ich nazwom i odmianie, osobno od `roleRegistry`.
174
+ 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`.
175
+
176
+ 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.
89
177
 
90
- Kod 0 oznacza poprawną konfigurację K2 i dokładnie cztery kompletne przypisania K7; 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.
178
+ 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.
91
179
 
92
- 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 P-18/K3.
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.
package/dist/cli.js CHANGED
@@ -1,11 +1,11 @@
1
1
  #!/usr/bin/env node
2
- import { realpathSync } from "node:fs";
3
- import { fileURLToPath, pathToFileURL } from "node:url";
2
+ import { lstatSync, realpathSync } from "node:fs";
3
+ import { fileURLToPath } from "node:url";
4
4
  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 { helperPath, isHelperServer, runHelper } from "./helpers.js";
8
+ import { isHelperServer, runHelper } from "./helpers.js";
9
9
  import { ROLE_IDS, ROLE_STEP } from "./manifest.js";
10
10
  import { doctorEngineConfig } from "./role-registry.js";
11
11
  const HELP = `robisie ${PACKAGE_VERSION} — łączy Twojego agenta z tablicą robisie
@@ -17,8 +17,12 @@ const HELP = `robisie ${PACKAGE_VERSION} — łączy Twojego agenta z tablicą r
17
17
  pomocnik ról (serwer MCP stdio) — uruchamia go agent, nie Ty
18
18
 
19
19
  Opcje doctor:
20
- --engine-config <path> lokalnie i offline sprawdza K2 i rejestr wykonania czterech ról K7
20
+ --engine-config <path> offline sprawdza strukturę konfiguracji projektu i przypisania czterech ról wykonania
21
21
  --engine-config=<path> ta sama składnia; nie sprawdza uruchomienia dostawców
22
+ Przykład: npx robisie doctor --engine-config ./robisie.config.json
23
+ Bez klucza i kontroli instalacji; nie sprawdza UUID projektu, repo, dostępności modeli ani wykonania komend.
24
+ Role wykonania w tym pliku są osobne od mapy ceo/builder/quality ustawianej przez init.
25
+ Przewodniki i przykłady: node_modules/robisie/docs/README.md oraz README.en.md w tym samym katalogu.
22
26
 
23
27
  Opcje init:
24
28
  --agent <${AGENT_IDS.join("|")}> wybrany dostawca (można powtórzyć albo podać po przecinku); razem z dostawcami mapy, bez --agent również wykryci
@@ -112,15 +116,15 @@ export async function run(argv, ctx) {
112
116
  return doctorEngineConfig(ctx, args.engineConfig);
113
117
  if (ctx.env.ROBISIE_KEY) {
114
118
  try {
115
- const helper = await import(pathToFileURL(helperPath("client-launch-context")).href);
116
- if (!helper || typeof helper !== "object" || !("resolveProjectContext" in helper)
117
- || typeof helper.resolveProjectContext !== "function")
118
- throw new Error("Invalid project-context export");
119
- const result = helper.resolveProjectContext(ctx.env, ctx.cwd);
120
- if (!result || typeof result !== "object" || !("projectContext" in result)
121
- || typeof result.projectContext !== "string" || !("plannerAccess" in result)
122
- || result.plannerAccess !== "configured")
123
- throw new Error("Invalid project-context result");
119
+ // Match the helper's directory rules without executing its code in doctor.
120
+ const selected = ctx.env.ROBISIE_PROJECT_CONTEXT || ctx.cwd;
121
+ if (!selected.startsWith("/") || selected.includes("\n"))
122
+ throw new Error("Invalid project-context path");
123
+ const selectedStat = lstatSync(selected);
124
+ const stat = lstatSync(realpathSync(selected));
125
+ if (selectedStat.isSymbolicLink() || !stat.isDirectory() || stat.isSymbolicLink()) {
126
+ throw new Error("Invalid project-context directory");
127
+ }
124
128
  }
125
129
  catch {
126
130
  throw new RobisieError("Nie mogę potwierdzić kontekstu projektu używanego przez pomocnik klienta.", "W katalogu projektu wykonaj `unset ROBISIE_PROJECT_CONTEXT`, potem `npx robisie doctor`. Albo ustaw istniejący absolutny rzeczywisty katalog: `export ROBISIE_PROJECT_CONTEXT='/absolutna/sciezka/do/projektu'` (zastąp ścieżkę katalogiem projektu), potem `npx robisie doctor`.");
package/dist/commands.js CHANGED
@@ -175,11 +175,6 @@ export async function doctor(ctx) {
175
175
  await guard(async () => {
176
176
  manifest = readManifest(paths.manifest);
177
177
  });
178
- await guard(async () => {
179
- const version = await fetchContractVersion(ctx);
180
- assertCompatible(version);
181
- ctx.out(`✓ Wersja kontraktu serwera ${version} pasuje do paczki.`);
182
- });
183
178
  const envKey = ctx.env[KEY_ENV]?.trim() || null;
184
179
  let key = envKey;
185
180
  let keyRead = false;
@@ -188,8 +183,15 @@ export async function doctor(ctx) {
188
183
  keyRead = true;
189
184
  });
190
185
  const usableKey = key;
186
+ if (!manifest && !usableKey && keyRead)
187
+ fail("Brak klucza robisie.", "Załóż konto lub zaloguj się na https://robisie.app; " + NO_KEY_STEP);
188
+ await guard(async () => {
189
+ const version = await fetchContractVersion(ctx);
190
+ assertCompatible(version);
191
+ ctx.out(`✓ Wersja kontraktu serwera ${version} pasuje do paczki.`);
192
+ });
191
193
  if (!usableKey) {
192
- if (keyRead)
194
+ if (keyRead && manifest)
193
195
  fail("Brak klucza robisie.", NO_KEY_STEP);
194
196
  }
195
197
  else if (!KEY_PATTERN.test(usableKey))
@@ -1,6 +1,6 @@
1
1
  /** Package identity and the server contract it speaks. */
2
2
  export declare const PACKAGE_NAME = "robisie";
3
- export declare const PACKAGE_VERSION = "0.1.1";
3
+ export declare const PACKAGE_VERSION = "0.1.3";
4
4
  /**
5
5
  * MAJOR of the agent-API contract this package understands.
6
6
  * PARITY: src/lib/mcp/contract-version.ts (AGENT_API_CONTRACT_VERSION) on the server.
package/dist/constants.js CHANGED
@@ -1,6 +1,6 @@
1
1
  /** Package identity and the server contract it speaks. */
2
2
  export const PACKAGE_NAME = "robisie";
3
- export const PACKAGE_VERSION = "0.1.1"; // x-release-please-version
3
+ export const PACKAGE_VERSION = "0.1.3"; // x-release-please-version
4
4
  /**
5
5
  * MAJOR of the agent-API contract this package understands.
6
6
  * PARITY: src/lib/mcp/contract-version.ts (AGENT_API_CONTRACT_VERSION) on the server.
package/dist/helpers.js CHANGED
@@ -52,14 +52,20 @@ export function runHelper(name) {
52
52
  if (settled)
53
53
  return;
54
54
  settled = true;
55
+ error = resultError ?? error;
55
56
  clearTimeout(timer);
56
57
  clearTimeout(parentTimer);
57
58
  process.off("SIGHUP", onHup);
58
59
  input.off("end", onEof);
59
60
  input.off("close", onEof);
60
61
  input.off("error", onStreamError);
61
- if (detached && child.stdin)
62
- input.unpipe(child.stdin);
62
+ try {
63
+ if (detached && child.stdin)
64
+ input.unpipe(child.stdin);
65
+ }
66
+ catch {
67
+ error ??= failure("strumień");
68
+ }
63
69
  process.off("SIGINT", onInt);
64
70
  process.off("SIGTERM", onTerm);
65
71
  child.off("exit", onExit);
@@ -157,16 +163,16 @@ export function runHelper(name) {
157
163
  return;
158
164
  }
159
165
  if (detached) {
160
- process.on("SIGINT", onInt);
161
- process.on("SIGTERM", onTerm);
162
- process.on("SIGHUP", onHup);
163
- // The agent may close npx rather than this CLI. Own the input pipe so EOF
164
- // interrupts active work even when npm does not forward process signals.
165
- input.on("end", onEof);
166
- input.on("close", onEof);
167
- input.on("error", onStreamError);
168
- child.stdin?.on("error", onStreamError);
169
166
  try {
167
+ process.on("SIGINT", onInt);
168
+ process.on("SIGTERM", onTerm);
169
+ process.on("SIGHUP", onHup);
170
+ // The agent may close npx rather than this CLI. Own the input pipe so EOF
171
+ // interrupts active work even when npm does not forward process signals.
172
+ input.on("end", onEof);
173
+ input.on("close", onEof);
174
+ input.on("error", onStreamError);
175
+ child.stdin?.on("error", onStreamError);
170
176
  if (!child.stdin)
171
177
  throw new Error("Missing helper stdin");
172
178
  input.pipe(child.stdin, { end: false });
package/dist/mcp.js CHANGED
@@ -1,6 +1,8 @@
1
1
  import { CONTRACT_VERSION_HEADER, PACKAGE_NAME, PACKAGE_VERSION, SUPPORTED_CONTRACT_MAJOR, mcpUrl, wellKnownUrl } from "./constants.js";
2
2
  import { RobisieError } from "./context.js";
3
3
  const TIMEOUT_MS = 15_000;
4
+ const RESPONSE_LIMIT_BYTES = 4_194_304;
5
+ const responseLimitErrors = new WeakSet();
4
6
  const UPDATE_STEP = "Zainstaluj z npm aktualną paczkę zgodną z kontraktem serwera; w katalogu instalacji wykonaj `npm i robisie@latest`, potem lokalne `npx robisie init` i `npx robisie doctor`.";
5
7
  /** Major of a semver string, or null when it is not one. */
6
8
  export function majorOf(version) {
@@ -33,11 +35,13 @@ export async function fetchContractVersion(ctx) {
33
35
  throw new RobisieError(`Serwer robisie odpowiedział błędem ${res.status} przy sprawdzaniu wersji.`, "Spróbuj ponownie za kilka minut; jeśli błąd zostaje, napisz do robisie.");
34
36
  }
35
37
  try {
36
- const body = await res.json();
38
+ const body = JSON.parse(await readText(res));
37
39
  const version = typeof body === "object" && body !== null ? body.contractVersion : undefined;
38
40
  return typeof version === "string" ? version : null;
39
41
  }
40
- catch {
42
+ catch (error) {
43
+ if (error instanceof RobisieError && responseLimitErrors.has(error))
44
+ throw error;
41
45
  return null;
42
46
  }
43
47
  }
@@ -50,6 +54,41 @@ function nonEmptyString(value) {
50
54
  function formatError() {
51
55
  return new RobisieError("Serwer robisie odpowiedział w nieznanym formacie.", UPDATE_STEP);
52
56
  }
57
+ /** Count actual bytes before decoding, including SSE frames already discarded by the parser. */
58
+ async function* readChunks(res) {
59
+ if (!res.body)
60
+ return;
61
+ const reader = res.body.getReader();
62
+ const decoder = new TextDecoder();
63
+ let bytes = 0;
64
+ try {
65
+ while (true) {
66
+ const { done, value } = await reader.read();
67
+ if (done) {
68
+ yield decoder.decode();
69
+ return;
70
+ }
71
+ bytes += value.byteLength;
72
+ if (bytes > RESPONSE_LIMIT_BYTES) {
73
+ const error = new RobisieError("Odpowiedź serwera robisie jest za duża (limit 4 MiB).", "Poproś administratora serwera o zmniejszenie odpowiedzi MCP do 4 MiB, potem uruchom ponownie `npx robisie doctor`.");
74
+ responseLimitErrors.add(error);
75
+ throw error;
76
+ }
77
+ yield decoder.decode(value, { stream: true });
78
+ }
79
+ }
80
+ finally {
81
+ // Cancellation may never settle; release ownership without delaying the result.
82
+ void reader.cancel().catch(() => { });
83
+ reader.releaseLock();
84
+ }
85
+ }
86
+ async function readText(res) {
87
+ let text = "";
88
+ for await (const chunk of readChunks(res))
89
+ text += chunk;
90
+ return text;
91
+ }
53
92
  /** Streamable HTTP answers either plain JSON or an SSE stream; pick our response out of either. */
54
93
  async function readRpc(res, id) {
55
94
  const matching = (candidate) => {
@@ -65,20 +104,12 @@ async function readRpc(res, id) {
65
104
  }
66
105
  return null;
67
106
  };
68
- let reader;
69
107
  try {
70
108
  if (!(res.headers.get("content-type") ?? "").includes("text/event-stream"))
71
- return matching(await res.text());
72
- if (!res.body)
73
- return null;
74
- reader = res.body.getReader();
75
- const decoder = new TextDecoder();
109
+ return matching(await readText(res));
76
110
  let buffer = "";
77
- while (true) {
78
- const { done, value } = await reader.read();
79
- if (done)
80
- return null; // EOF never completes an unterminated SSE event.
81
- buffer += decoder.decode(value, { stream: true });
111
+ for await (const chunk of readChunks(res)) {
112
+ buffer += chunk;
82
113
  let boundary;
83
114
  while ((boundary = /\r?\n\r?\n/.exec(buffer)) !== null) {
84
115
  const event = buffer.slice(0, boundary.index);
@@ -92,17 +123,13 @@ async function readRpc(res, id) {
92
123
  return message;
93
124
  }
94
125
  }
126
+ return null; // EOF never completes an unterminated SSE event.
95
127
  }
96
- catch {
128
+ catch (error) {
129
+ if (error instanceof RobisieError && responseLimitErrors.has(error))
130
+ throw error;
97
131
  throw new RobisieError("Nie mogę odczytać odpowiedzi serwera robisie.", "Sprawdź połączenie i uruchom ponownie `npx robisie doctor`.");
98
132
  }
99
- finally {
100
- if (reader) {
101
- // Cancellation may never settle; release ownership without delaying the RPC result.
102
- void reader.cancel().catch(() => { });
103
- reader.releaseLock();
104
- }
105
- }
106
133
  }
107
134
  async function rpc(ctx, key, id, method, params) {
108
135
  const res = await request(ctx, mcpUrl(ctx.origin), {
@@ -37,7 +37,7 @@ export function parseOpenCodeStream(raw, model) {
37
37
  sessionId = event.sessionID;
38
38
  const type = event.type, partType = part.type;
39
39
  if (!["step_start", "reasoning", "tool_use", "text", "step_finish"].includes(type)) {
40
- throw new Error(`OpenCode stream event is unsupported: ${String(type)}`);
40
+ throw new Error("OpenCode stream event is unsupported");
41
41
  }
42
42
  const messageId = part.messageID;
43
43
  if (messageId !== undefined && (typeof messageId !== "string" || !SAFE_STREAM_ID.test(messageId)))
@@ -1,7 +1,7 @@
1
1
  import { type Ctx } from "./context.js";
2
2
  import { type EngineConfig } from "./engine-config.js";
3
3
  declare const ROLES: readonly ["worker-client", "lead-client", "reviewer-client", "tester-client"];
4
- declare const PROVIDERS: readonly ["codex", "claude", "opencode", "grok"];
4
+ export declare const PROVIDERS: readonly ["codex", "claude", "opencode", "grok"];
5
5
  export type EngineRoleRegistry = Record<typeof ROLES[number], {
6
6
  name: string;
7
7
  provider: typeof PROVIDERS[number];
@@ -10,6 +10,12 @@ export type EngineRoleRegistry = Record<typeof ROLES[number], {
10
10
  }>;
11
11
  /** Separate from K2 roles (names/inflections) and K7's resource RoleRegistry. */
12
12
  export declare function parseRoleRegistry(raw: unknown, configPath: string): EngineRoleRegistry;
13
+ /** Select CLI/model/effort from the parsed registry; manufacturer and profile metadata belong to the caller. */
14
+ export declare function resolveRoleExecution(registry: EngineRoleRegistry, role: string): {
15
+ provider: typeof PROVIDERS[number];
16
+ model: string;
17
+ effortRequested: string;
18
+ };
13
19
  /** One read and one JSON object shared by the K2 and registry validators. */
14
20
  export declare function loadRoleRegistryConfig(path: string): {
15
21
  config: EngineConfig;
@@ -4,7 +4,7 @@ import { RobisieError, errorMessage } from "./context.js";
4
4
  import { CONFIG_FILE, parseEngineConfig } from "./engine-config.js";
5
5
  // K7 ROLE_NAMES; kept local so the package has no vendor runtime dependency.
6
6
  const ROLES = ["worker-client", "lead-client", "reviewer-client", "tester-client"];
7
- const PROVIDERS = ["codex", "claude", "opencode", "grok"];
7
+ export const PROVIDERS = ["codex", "claude", "opencode", "grok"];
8
8
  const FIELDS = ["name", "provider", "model", "effort"];
9
9
  function fail(configPath, field, reason) {
10
10
  throw new RobisieError(`${configPath}: ${field}: ${reason}`, `Popraw wskazane pole w pliku „${configPath}” i ponów \`npx robisie doctor --engine-config <path>\` z tą ścieżką.`);
@@ -20,7 +20,7 @@ export function parseRoleRegistry(raw, configPath) {
20
20
  const registry = raw.roleRegistry;
21
21
  for (const role of Object.keys(registry)) {
22
22
  if (!ROLES.includes(role))
23
- fail(configPath, `roleRegistry.${role}`, "nieznana rola; dozwolone: " + ROLES.join(", "));
23
+ fail(configPath, "roleRegistry", "nieznana rola; dozwolone: " + ROLES.join(", "));
24
24
  }
25
25
  const result = {};
26
26
  for (const role of ROLES) {
@@ -30,7 +30,7 @@ export function parseRoleRegistry(raw, configPath) {
30
30
  const entry = registry[role];
31
31
  for (const key of Object.keys(entry)) {
32
32
  if (!FIELDS.includes(key))
33
- fail(configPath, `${path}.${key}`, "nieznane pole; dozwolone: " + FIELDS.join(", "));
33
+ fail(configPath, path, "nieznane pole; dozwolone: " + FIELDS.join(", "));
34
34
  }
35
35
  for (const field of FIELDS) {
36
36
  if (!Object.hasOwn(entry, field) || typeof entry[field] !== "string" || !entry[field].trim()) {
@@ -45,6 +45,14 @@ export function parseRoleRegistry(raw, configPath) {
45
45
  }
46
46
  return result;
47
47
  }
48
+ /** Select CLI/model/effort from the parsed registry; manufacturer and profile metadata belong to the caller. */
49
+ export function resolveRoleExecution(registry, role) {
50
+ if (!ROLES.includes(role) || !Object.hasOwn(registry, role)) {
51
+ throw new RobisieError("Brak wybranej roli w rejestrze.", "Wybierz rolę obecną w sprawdzonej konfiguracji rejestru.");
52
+ }
53
+ const entry = registry[role];
54
+ return { provider: entry.provider, model: entry.model, effortRequested: entry.effort };
55
+ }
48
56
  /** One read and one JSON object shared by the K2 and registry validators. */
49
57
  export function loadRoleRegistryConfig(path) {
50
58
  const configPath = resolve(path);
package/dist/roles.d.ts CHANGED
@@ -17,7 +17,7 @@ export interface Role {
17
17
  export declare function rolesDir(): string;
18
18
  export declare function parseRole(file: Role["file"], text: string): Role;
19
19
  export declare function loadRoles(dir?: string): Role[];
20
- export declare const MANAGED_LINE = "<!-- robisie:managed 0.1.1 \u2014 plik zarz\u0105dzany przez `npx robisie`; `npx robisie uninstall` go usunie -->";
20
+ export declare const MANAGED_LINE = "<!-- robisie:managed 0.1.3 \u2014 plik zarz\u0105dzany przez `npx robisie`; `npx robisie uninstall` go usunie -->";
21
21
  export type AgentFlavor = "claude" | "codex" | "opencode";
22
22
  /** How the operator starts the Builder for one card in its own session (the card id is not a secret). */
23
23
  export declare function builderStartCommand(flavor: AgentFlavor, codexRolePath?: string): string;
@@ -4,6 +4,8 @@ Po instalacji `npm i robisie` używaj publicznego importu `robisie/dist/planer-c
4
4
 
5
5
  Caller przekazuje `config`: **dokładnie jedno z `origin` XOR `endpoint`**, np. `origin: 'https://robisie.app'` albo `endpoint: 'https://robisie.app/api/mcp'`, oraz własny `token`. Opcjonalne `fetch` pozwala wstrzyknąć transport (w teście wyłącznie fixture); bez niego SDK używa natywnego fetch. Opcjonalne `deadlineMs` ogranicza czas żądania. SDK nie pobiera tokena z pliku ani środowiska. Nie generuj, nie osadzaj i nie loguj tokena; przekaż go z bezpiecznego źródła callera poza rozmową i historią poleceń.
6
6
 
7
+ W obu przykładach wynik operacji i diagnostyka zamknięcia są oddzielne: błąd `close` nie zastępuje wyniku ani pierwotnego błędu operacji. Emituje tylko stałe ostrzeżenie, bez wyjątku, konfiguracji i patcha; awaria samej konsoli również nie zmienia wyniku. Błąd zamknięcia nie uzasadnia ponowienia append — zapis mógł już zostać wykonany.
8
+
7
9
  ## Odczyt i jednoznaczny wybór
8
10
 
9
11
  Wywołaj `readCard(config, selection)`. `selection` może zawierać `projectId`, `trackId` i `id` rozpoznane przez callera. Brak identyfikatora pozwala kontynuować tylko wtedy, gdy discovery zwraca dokładnie jedną pozycję na danym poziomie. Przy pustej liście, braku wskazanego ID albo wielu kandydatach wynik `wybierz-jednoznacznie` wskazuje etap; caller ustala wybór przed kolejnym odczytem. Nie wybieraj przypadkowej pierwszej pozycji. Ten odczyt niczego nie zapisuje ani nie tworzy brakujących obiektów.
@@ -37,7 +39,11 @@ export async function readCard(config, {
37
39
  const task = await client.getTask({ id: tasks[0].id, include });
38
40
  return { outcome: task === null ? 'brak-karty' : 'odczytano', task };
39
41
  } finally {
40
- await client.close();
42
+ try { await client.close(); }
43
+ catch {
44
+ try { console.warn('Nie udało się zamknąć klienta.'); }
45
+ catch { /* awaria diagnostyki nie zmienia wyniku */ }
46
+ }
41
47
  }
42
48
  }
43
49
  ```
@@ -65,7 +71,11 @@ export async function appendCard(config, { id, patch }) {
65
71
  }
66
72
  throw error;
67
73
  } finally {
68
- await client.close();
74
+ try { await client.close(); }
75
+ catch {
76
+ try { console.warn('Nie udało się zamknąć klienta.'); }
77
+ catch { /* awaria diagnostyki nie zmienia wyniku */ }
78
+ }
69
79
  }
70
80
  }
71
81
  ```
@@ -31,6 +31,8 @@ Spacje w argumencie i metaznaki są danymi. Przykładowe `a b` i `$(never-run)`
31
31
  mają pozostać dosłowne; nie sklejaj argv w polecenie powłoki. Poniższy odczyt
32
32
  nie wykonuje nawet testu, lintowania ani budowania. Komendy są ilustracyjne
33
33
  i wymagają podmiany przed wykorzystaniem konfiguracji do wykonywania pracy.
34
+ Nie wpisuj sekretów do argv — argumenty mogą trafić do listy procesów lub logów
35
+ narzędzi wykonujących komendy.
34
36
  `delivery: "pr"` opisuje sposób dostarczenia; sam odczyt nie tworzy PR.
35
37
 
36
38
  Role silnika to `coordinator`, `owner`, `planner`, `advisor`.
@@ -80,7 +82,7 @@ try {
80
82
  const configPath = process.argv[2];
81
83
  if (!configPath) throw new Error('Podaj ścieżkę do robisie.config.json');
82
84
  const config = loadEngineConfig(configPath);
83
- console.log(JSON.stringify(config));
85
+ console.log(`Konfiguracja poprawna. Tory: ${config.tracks.length}; komendy: ${Object.keys(config.engine.commands).length}; kontrole: ${config.engine.requiredChecks.length}.`);
84
86
  } catch (error) {
85
87
  console.error(error instanceof Error ? error.message : String(error));
86
88
  process.exitCode = 1;
@@ -95,20 +97,16 @@ node read-engine-config.mjs /absolutna/sciezka/robisie.config.json
95
97
  ```
96
98
 
97
99
  Katalog skryptu może być inny niż katalog konfiguracji. Sukces oznacza exit 0,
98
- pusty stderr i jeden obiekt JSON na stdout. Poniżej kształt wybranych pól wyniku
99
- dla powyższej ścieżki (pozostałe pola konfiguracji też są wypisywane):
100
+ pusty stderr i jedną linię na stdout: stałe etykiety oraz liczby torów, komend
101
+ i wymaganych kontroli. Wartości pól i nazwy kluczy konfiguracji nie są wypisywane.
102
+ Dla powyższego JSON wynik to:
100
103
 
101
104
  ```text
102
- configPath: "/absolutna/sciezka/robisie.config.json"
103
- stateDir: "/absolutna/state with spaces"
104
- engine.repo: "/absolutna/repo with spaces"
105
- engine.commands.test: ["node", "a b", "$(never-run)"]
106
- engine.delivery: "pr"
107
- roles.owner: {"name":"Ala","forms":["Ala","Ali"],"genitive":"Ali"}
105
+ Konfiguracja poprawna. Tory: 1; komendy: 3; kontrole: 3.
108
106
  ```
109
107
 
110
- Ścieżka pliku jest kanonizowana, więc przy dowiązaniach wynik wskazuje jego
111
- rzeczywistą lokalizację. Brak pliku, niepoprawny JSON lub błędne pola kończą
108
+ Ścieżka pliku jest kanonizowana we wczytanym obiekcie `config`, więc przy
109
+ dowiązaniach wskazuje jego rzeczywistą lokalizację. Brak pliku, niepoprawny JSON lub błędne pola kończą
112
110
  odczyt z niezerowym exit i komunikatem na stderr. Na przykład brak `test`
113
111
  w `engine.commands` daje błąd zawierający `engine.commands.test`, a
114
112
  `delivery: "invalid"` — `engine.delivery`. Odczyt nie dopisuje brakujących