robisie 0.1.3 → 0.1.4

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,14 @@
1
1
  # Historia zmian klienta / Client changelog
2
2
 
3
+ ## 0.1.4 (2026-11-04)
4
+
5
+ Wydanie poprawek dokumentacji. / Documentation patch release.
6
+
7
+ - 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.
8
+ - 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.
9
+ - 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.
10
+ - Testy dokumentacji: nowy `docs-014` oraz dostosowane istniejące testy przewodników. / Documentation tests: new `docs-014` and adjusted existing guide tests.
11
+
3
12
  ## 0.1.3 (2026-11-04)
4
13
 
5
14
  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 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 `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,16 +14,26 @@ 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
+ 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
30
 
21
31
  ```sh
22
32
  cd "/ścieżka/do/pustego katalogu" &&
23
33
  node -e 'try {
24
34
  require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
25
35
  } catch (error) {
26
- console.error(error.message);
36
+ 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
37
  process.exit(1);
28
38
  }' &&
29
39
  {
@@ -49,7 +59,7 @@ npx robisie doctor
49
59
 
50
60
  Ł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
61
 
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ę.
62
+ 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
63
 
54
64
  <!-- reinstall:start -->
55
65
  ```sh
@@ -89,16 +99,18 @@ Dla Codex lub OpenCode zastąp `claude` przez `codex` lub `opencode`. Sam `--age
89
99
 
90
100
  ## Po init — sprawdź gotowość CEO
91
101
 
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.
102
+ 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
103
 
94
104
  - **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.
105
+ - **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
106
  - **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
107
 
98
108
  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
109
 
100
110
  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
111
 
112
+ 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.
113
+
102
114
  ## Start CEO
103
115
 
104
116
  Człowiek uruchamia CEO w katalogu instalacji.
@@ -113,12 +125,25 @@ W Claude Code CEO uruchamia niezależnego Quality Officera przez `Agent(quality-
113
125
 
114
126
  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
127
 
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.
128
+ 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
129
 
118
130
  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
131
 
132
+ ### Aktualizacja przed pierwszym init
133
+
134
+ 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.
135
+
136
+ <!-- before-init-update:start -->
137
+ ```sh
138
+ npm i robisie@latest
139
+ ```
140
+ <!-- before-init-update:end -->
141
+
142
+ ### Aktualizacja po init
143
+
120
144
  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
145
 
146
+ <!-- update:start -->
122
147
  ```sh
123
148
  set +x
124
149
  {
@@ -137,6 +162,7 @@ npm i robisie@latest &&
137
162
  npx robisie init &&
138
163
  npx robisie doctor
139
164
  ```
165
+ <!-- update:end -->
140
166
 
141
167
  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
168
 
@@ -177,4 +203,4 @@ Kod 0 oznacza poprawną strukturę konfiguracji i dokładnie cztery kompletne pr
177
203
 
178
204
  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
205
 
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.
206
+ 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.
@@ -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.3";
3
+ export declare const PACKAGE_VERSION = "0.1.4";
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.3"; // x-release-please-version
3
+ export const PACKAGE_VERSION = "0.1.4"; // 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.
@@ -5,12 +5,17 @@ async function robisieReviewGuard() {
5
5
  "tool.execute.before": async (input, output) => {
6
6
  if (typeof input !== "object" || input === null || !("tool" in input))
7
7
  return;
8
- if (input.tool !== "robisie_create_task" && input.tool !== "robisie_update_task")
8
+ if (input.tool !== "robisie_create_task" && input.tool !== "robisie_update_task" && input.tool !== "robisie_create_tasks")
9
9
  return;
10
10
  if (typeof output !== "object" || output === null || !("args" in output))
11
11
  return;
12
12
  const args = output.args;
13
- if (typeof args === "object" && args !== null && "status" in args && args.status === "delivered") {
13
+ if (typeof args !== "object" || args === null)
14
+ return;
15
+ const delivered = input.tool === "robisie_create_tasks"
16
+ ? "tasks" in args && Array.isArray(args.tasks) && args.tasks.some((task) => typeof task === "object" && task !== null && "status" in task && (task.status === "delivered" || task.status === "wdrożone"))
17
+ : "status" in args && (args.status === "delivered" || args.status === "wdrożone");
18
+ if (delivered) {
14
19
  throw new Error("Brak wspieranego protokołu recenzji w OpenCode. Ta próba nie zmieniła karty.");
15
20
  }
16
21
  },
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.3 \u2014 plik zarz\u0105dzany przez `npx robisie`; `npx robisie uninstall` go usunie -->";
20
+ export declare const MANAGED_LINE = "<!-- robisie:managed 0.1.4 \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;
@@ -0,0 +1,10 @@
1
+ export type SeedPackage = Readonly<{
2
+ scope: string;
3
+ spec: string;
4
+ brief: string;
5
+ }>;
6
+ export declare function embeddedDetails(card: Readonly<{
7
+ details: unknown;
8
+ }>, seedPackage: SeedPackage): Record<string, unknown>;
9
+ export declare function readbackMismatches(details: unknown, seedPackage: SeedPackage): string[];
10
+ export declare function parseSeedPackage(raw: string): SeedPackage;
@@ -0,0 +1,62 @@
1
+ import { createHash } from "node:crypto";
2
+ function isRecord(value) {
3
+ return value !== null && typeof value === "object" && !Array.isArray(value);
4
+ }
5
+ function stripFence(text) {
6
+ let value = text.trim();
7
+ const opening = value.match(/^```(?:json)?\s*/i);
8
+ if (opening !== null)
9
+ value = value.slice(opening[0].length);
10
+ value = value.replace(/\s*```\s*$/, "");
11
+ return value.trim();
12
+ }
13
+ function errorText(error) {
14
+ return error instanceof Error ? error.message : String(error);
15
+ }
16
+ function sha256(content) {
17
+ return createHash("sha256").update(content, "utf8").digest("hex");
18
+ }
19
+ export function embeddedDetails(card, seedPackage) {
20
+ const original = isRecord(card.details) ? card.details : {};
21
+ return {
22
+ ...(Object.hasOwn(original, "card_class") ? {} : { card_class: "executable" }),
23
+ seed_scope: seedPackage.scope,
24
+ seed_scope_sha256: sha256(seedPackage.scope),
25
+ seed_spec: seedPackage.spec,
26
+ seed_spec_sha256: sha256(seedPackage.spec),
27
+ seed_brief: seedPackage.brief,
28
+ seed_brief_sha256: sha256(seedPackage.brief),
29
+ };
30
+ }
31
+ export function readbackMismatches(details, seedPackage) {
32
+ if (!isRecord(details))
33
+ return ["details nie są obiektem"];
34
+ const mismatches = [];
35
+ for (const field of ["scope", "spec", "brief"]) {
36
+ const contentKey = `seed_${field}`;
37
+ const hashKey = `${contentKey}_sha256`;
38
+ const content = details[contentKey];
39
+ const expected = seedPackage[field];
40
+ if (content !== expected || typeof content !== "string" || details[hashKey] !== sha256(content)) {
41
+ mismatches.push(contentKey);
42
+ }
43
+ }
44
+ return mismatches;
45
+ }
46
+ export function parseSeedPackage(raw) {
47
+ let parsed;
48
+ try {
49
+ parsed = JSON.parse(stripFence(raw));
50
+ }
51
+ catch (error) {
52
+ throw new Error(`odpowiedź modelu nie jest JSON: ${errorText(error)}`);
53
+ }
54
+ if (!isRecord(parsed))
55
+ throw new Error("odpowiedź modelu nie jest obiektem");
56
+ for (const field of ["scope", "spec", "brief"]) {
57
+ if (typeof parsed[field] !== "string" || parsed[field].trim().length === 0) {
58
+ throw new Error(`brak niepustego pola ${field}`);
59
+ }
60
+ }
61
+ return { scope: parsed.scope, spec: parsed.spec, brief: parsed.brief };
62
+ }
@@ -0,0 +1 @@
1
+ export declare function taskMktempEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
@@ -0,0 +1,40 @@
1
+ import { lstatSync, mkdtempSync, writeFileSync } from "node:fs";
2
+ import path from "node:path";
3
+ import { workerEnv } from "./worker-env.js";
4
+ // Only omitted templates need rewriting; explicit paths and unknown options belong to mktemp.
5
+ const wrapper = `#!/bin/bash
6
+ if [[ -z "$TMPDIR" || "$TMPDIR" != /* || ! -d "$TMPDIR" || ! -w "$TMPDIR" ]]; then
7
+ echo 'ACTIONABLE: brak zapisywalnego TMPDIR zadania' >&2
8
+ exit 1
9
+ fi
10
+ original=("$@")
11
+ flags=()
12
+ prefix=tmp
13
+ while getopts ':dqut:p:' flag; do
14
+ case "$flag" in
15
+ d|q|u) flags+=("-$flag") ;;
16
+ t) prefix="$OPTARG" ;;
17
+ *) exec /usr/bin/mktemp "\${original[@]}" ;;
18
+ esac
19
+ done
20
+ shift "$((OPTIND - 1))"
21
+ if (( $# > 0 )); then exec /usr/bin/mktemp "\${original[@]}"; fi
22
+ if [[ "$prefix" == */* ]]; then
23
+ echo 'mktemp: prefix must not contain a slash' >&2
24
+ exit 1
25
+ fi
26
+ exec /usr/bin/mktemp "\${flags[@]}" "$TMPDIR/$prefix.XXXXXXXX"
27
+ `;
28
+ export function taskMktempEnv(env) {
29
+ try {
30
+ const tmp = env.TMPDIR;
31
+ if (!tmp || !path.isAbsolute(tmp) || !lstatSync(tmp).isDirectory())
32
+ throw new Error("brak katalogu zadania");
33
+ const bin = mkdtempSync(path.join(tmp, "mktemp-bin-"));
34
+ writeFileSync(path.join(bin, "mktemp"), wrapper, { mode: 0o700, flag: "wx" });
35
+ return { ...workerEnv(env, tmp), PATH: `${bin}${path.delimiter}${env.PATH ?? ""}` };
36
+ }
37
+ catch (error) {
38
+ throw new Error(`ACTIONABLE: podkładka mktemp TMPDIR zadania: ${error instanceof Error ? error.message : String(error)}`);
39
+ }
40
+ }
package/docs/README.en.md CHANGED
@@ -1,4 +1,4 @@
1
- # robisie — from account to accepted card (package 0.1.3)
1
+ # robisie — from account to accepted card (package 0.1.4)
2
2
 
3
3
  Polski: [README.md](README.md).
4
4
 
@@ -9,7 +9,7 @@ An account and key are needed for init and the roles. Offline configuration vali
9
9
 
10
10
  Install robisie from npm in the prepared directory; run subsequent commands and agent sessions there. [Preparation](#wymagania) → [account](#konto) → [key](#klucz) → [installation](#instalacja) → [acceptance](#recenzja-i-odbior).
11
11
 
12
- The CHANGELOG entry about registry README readback describes a release check, not proof that a particular publication has a nonempty README. E4 observed an empty registry README while the tarball contained the guides; use `node_modules/robisie/docs/` locally. Registry metadata, publication and historical CHANGELOG correction require separate release work.
12
+ If the registry README is empty, use the guides shipped locally at `node_modules/robisie/docs/`. Registry metadata and publication require separate release work.
13
13
 
14
14
  <!-- sekcja: wymagania -->
15
15
  <a id="wymagania"></a>
@@ -25,13 +25,19 @@ Prepare an empty directory on disk. You do not need a website or your own `packa
25
25
 
26
26
  The human signs in at https://robisie.app with Google or an email link. Wait for the first project's readiness screen. If readiness is missing, use the fallback link to https://robisie.app/dashboard/plugins/planer and prepare a project in the dashboard; the bounded readiness checks are not a provisioning time guarantee.
27
27
 
28
- Discovery is the authenticated read of active projects through `list_projects`; the key scopes what the agent sees. The CEO requires authenticated discovery to return exactly one project. A dashboard project is not a directory on disk: confirm with the CEO that both concern the same goal before work. With zero projects, the human checks readiness and the dashboard fallback; with several, the human must organize/archive extras until discovery returns one. Clicking a project does not bind it for the CEO. Do not supply a project UUID in chat; the CEO takes its identifier only from discovery. Result: one recognized project before any agent write.
28
+ Project lookup is the authenticated read of active projects through `list_projects`; the key scopes what the agent sees. The CEO requires authenticated `list_projects` to return exactly one project. A dashboard project is not a directory on disk: confirm with the CEO that both concern the same goal before work. With zero projects, the human checks readiness and the dashboard fallback; with several, the human must organize/archive extras until `list_projects` returns one. Clicking a project does not bind it for the CEO. Do not supply a project UUID in chat; the CEO takes its identifier only from `list_projects`. Result: one recognized project before any agent write.
29
29
 
30
30
  <!-- sekcja: klucz -->
31
31
  <a id="klucz"></a>
32
32
  ## Key in Connect
33
33
 
34
- An agent may create its own account and generate its key, within the account owner’s authorization. A human may need to confirm sign-in or another protected step; then continue after that confirmation. Someone else’s open session does not authorize using their account or key. Keep secrets out of chat and command history; if the available tools cannot supply a secret safely, the human enters it in the hidden init prompt.
34
+ <!-- agent-consent:start -->
35
+ ### Agent instructions — one authorization for the flow
36
+
37
+ At the start, ask once for authorization for a named flow and its boundaries: your own account, permission to generate a key, secure local storage of the key, init and the first agreed card (goal, directory, write scope and result criteria). The first-card example below covers only `wynik.txt`; agree on it with the owner before asking for authorization.
38
+
39
+ If the owner has already authorized this flow, do not ask again at those steps; continue within the agreed boundaries. A missing authorization, null, empty or unclear answer or scope change requires a question before the dependent step; continue independent authorized work. Respect a refusal: do not perform the refused steps. Authorization does not bypass protected human or provider confirmations; continue after confirmation. Keep the key out of chat, cards, arguments and command history; if secure storage or transfer is unavailable, the human uses init's hidden prompt. Someone else's open session gives no access to their account. Independent review and separate final acceptance of the result by the owner are still required.
40
+ <!-- agent-consent:end -->
35
41
 
36
42
  At https://robisie.app/dashboard/connect the human selects `worker` and a recognizable label, such as “tester laptop”, then generates the key. It is shown only once: store it like a password. The human supplies it outside chat to init's hidden prompt, never to chat, a card, a command argument or shell history.
37
43
 
@@ -43,14 +49,18 @@ The package stores **one key for CEO, Builder and Quality Officer** as `ROBISIE_
43
49
  <a id="instalacja"></a>
44
50
  ## Install from npm
45
51
 
46
- After preparing the account and key, the human opens a terminal and enters the chosen empty directory (replace the example path below). The Node.js step below creates a local `package.json` regardless of the directory name, including spaces and Polish characters. The manifest sets the installation directory even under an ancestor containing `node_modules`. If the `package.json` path already exists (including a symlink), the step refuses to write; it never overwrites it. EEXIST means the path exists: use the existing-project route below; resolve a link/directory first. Failure to enter the directory or create the manifest stops the rest of the block. Then: install, init with the hidden key prompt, doctor. In zsh/bash clear stale ENV before init and load the saved key before doctor — init cannot set its parent environment:
52
+ All three installer roles use one provider: CEO (`ceo`), Builder (`builder`), Quality Officer (`quality`). Mixed assignments do not route execution across providers and doctor returns exit 1. For Claude, use the full assignment `npx robisie init --agent claude --role ceo=claude --role builder=claude --role quality=claude` in place of the init line below. For Codex/OpenCode, replace every `claude` with `codex`/`opencode`; `--agent` alone does not clear an earlier map.
53
+
54
+ The installer settings `ceo`/`builder`/`quality` (CEO/Builder/Quality Officer) are separate from the execution registry `roleRegistry`: `worker-client`, `lead-client`, `reviewer-client`, `tester-client`. Project names `coordinator`/`owner`/`planner`/`advisor` are another setting. There is no automatic conversion between these settings; the registry does not enable mixed installer-role execution.
55
+
56
+ After preparing the account and key, the human opens a terminal and enters the chosen empty directory (replace the example path below). The Node.js step below creates a local `package.json` regardless of the directory name, including spaces and Polish characters. The manifest sets the installation directory even under an ancestor containing `node_modules`. If the `package.json` path already exists (including a symlink), the step refuses to write; it never overwrites it. Failure to enter the directory or create the manifest stops the rest of the block. Then: install, init with the hidden key prompt, doctor. In zsh/bash clear stale ENV before init and load the saved key before doctor — init cannot set its parent environment:
47
57
 
48
58
  ```sh
49
59
  cd "/path/to/empty directory" &&
50
60
  node -e 'try {
51
61
  require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
52
62
  } catch (error) {
53
- console.error(error.message);
63
+ console.error("Cannot create package.json; it may already exist or the path may be inaccessible. Next step: preserve the path and use the existing-project/reinstallation instructions below; resolve links/directories or access errors locally before retrying.");
54
64
  process.exit(1);
55
65
  }' &&
56
66
  {
@@ -76,7 +86,7 @@ npx robisie doctor
76
86
 
77
87
  The `&&` chain stops the block at the first error; assigning the key separately before `export` preserves the read status so doctor cannot mask it. After resolving the cause, retry the failed step and every subsequent step from the block in the same directory. If the manifest was already created, do not repeat its creation or delete it.
78
88
 
79
- For an existing project without `package.json`, run the fresh-install block above in that project directory: it creates only a private manifest and preserves other project files. If a regular manifest already exists, or you are reinstalling with a retained valid key, use the block below in the chosen project directory. It loads the saved key before npm/init/doctor, does not overwrite a regular manifest during preparation, and creates one with `wx` only if absent. npm itself may then add the robisie dependency and change the lockfile. It refuses a manifest link (including a dangling link) or directory with an explanation. After uninstall, when no valid key remains, return to Connect and the hidden init prompt: for an existing regular manifest run the fresh-install block from `set +x` through doctor, without its `cd`/manifest creation step. Do not delete a manifest to repeat installation.
89
+ For an existing project without `package.json`, run the fresh-install block above in that project directory: it creates only a private manifest and preserves other project files. If a regular manifest already exists, or you are reinstalling with a retained valid key, use the block below in the chosen project directory. It loads the saved key before npm/init/doctor, does not overwrite a regular manifest during preparation, and creates one with `wx` only if absent. npm itself may then add the robisie dependency and change the lockfile. It refuses a manifest link (including a dangling link) or directory with an explanation. After uninstall preserve the retained `package.json`. When no valid key remains, return to Connect and the hidden init prompt: for an existing regular manifest run the fresh-install block from `set +x` through doctor, without its `cd`/manifest creation step. Do not delete a manifest to repeat installation.
80
90
 
81
91
  <!-- reinstall:start -->
82
92
  ```sh
@@ -188,9 +198,9 @@ Doctor runs the helper file via node, the agent via npx. `ROBISIE_PROJECT_CONTEX
188
198
  <!-- sekcja: pierwsza-karta -->
189
199
  ## First card and Builder startup
190
200
 
191
- The human starts the CEO in the installation directory: `claude --agent ceo-client`, or `codex` and requests the robisie CEO role (reading the full file referenced by AGENTS.md), or `opencode` and selects `ceo-client`. After successful discovery use this request, which works after npm installation with just README:
201
+ The human starts the CEO in the installation directory: `claude --agent ceo-client`, or `codex` and requests the robisie CEO role (reading the full file referenced by AGENTS.md), or `opencode` and selects `ceo-client`. After a successful project lookup use this request, which works after npm installation with just README:
192
202
 
193
- > Create wynik.txt in this directory with exactly “robisie działa” followed by a newline. Read it back and verify the exact contents. Boundaries: this file only, no dependencies, accounts or publication. Prepare the scope and wait for my approval; after the work I need independent review and my acceptance.
203
+ > Create wynik.txt in this directory with exactly “robisie działa” followed by a newline. Read it back and verify the exact contents. Boundaries: this file only, no dependencies, accounts or publication. Use my existing authorization if it covers this exact scope; otherwise ask before work. After the work I need independent review and separate final acceptance.
194
204
 
195
205
  After human approval, the CEO by default calls `spawn_builder` with the ID of the card confirmed in `ready`. The full flow in Claude Code is: `draft` → `ready` → `in_progress` → `in_review` → independent review and verified receipt → `delivered` → owner acceptance → `done`; see [Review and explicit acceptance](#recenzja-i-odbior) for acceptance limits in other sessions.
196
206
 
@@ -216,13 +226,25 @@ In Claude Code, the CEO starts an independent Quality Officer through `Agent(qua
216
226
 
217
227
  OpenCode: the card stays in `in_review` regardless of the availability of the Agent tool; there is no supported transition to `delivered`. Full acceptance requires the Claude Code route described above. A task/VERIFIED result, role label or receipt JSON alone does not open this transition; do not bypass a refusal with a manual status change or self-review.
218
228
 
219
- In other CEO sessions, including Codex, moving to delivered requires independent review and a verified receipt. If the CEO session lacks the Agent tool, the card stays in `in_review`: this is a product capability gap for CEO/CR to resolve. Do not substitute Builder self-review or a manual status change. Installing three roles does not provide that integration.
229
+ In other CEO sessions, including Codex, moving to delivered requires independent review and a verified receipt. If the CEO session lacks the Agent tool, the card stays in `in_review`: this is a product capability gap for the person responsible for the CEO integration to resolve. Do not substitute Builder self-review or a manual status change. Installing three roles does not provide that integration.
220
230
 
221
231
  The project owner can use Dashboard → Planer → card → Etap → “Zrobione” to move `delivered` to `done`, including when the agent uses a `worker` key. For the first card described here, the server does not enforce stored acceptance or evidence before a change to `done`: the dashboard lets the owner select “Zrobione” even without them. Do this only after checking and explicitly accepting the result. The dashboard cannot edit `details`; review and evidence are recorded through the supported board tool flow. This guide alone does not prove a customer has completed that flow.
222
232
 
223
233
  <!-- sekcja: aktualizacja -->
224
234
  ## Update and private backup
225
235
 
236
+ ### Update before the first init
237
+
238
+ In the prepared installation directory, before the first init, updating the npm package needs neither a key nor the installer's `manifest.json`. Preserve an existing project manifest; for an empty directory first create the local `package.json` using only the Node step above. Then run this one line; continue with the chosen init recipe when the account and key are ready.
239
+
240
+ <!-- before-init-update:start -->
241
+ ```sh
242
+ npm i robisie@latest
243
+ ```
244
+ <!-- before-init-update:end -->
245
+
246
+ ### Update after init
247
+
226
248
  Work in the installation directory. First prepare the backup below. Explicitly choose the previous release compatible with the server contract MAJOR; inspect the installed version with `node -p 'require("./node_modules/robisie/package.json").version'`. Replace the example `previous_version='0.1.1'` with that chosen version. `npm pack robisie@<wersja>` means pack the explicitly selected release, not an arbitrary tgz. Retain its filename and the backup directory. Disable xtrace; never print or paste secrets.
227
249
 
228
250
  ```sh
@@ -242,39 +264,66 @@ Keep the installation's HOME, XDG_CONFIG_HOME and CODEX_HOME values (the command
242
264
 
243
265
  Missing/null/empty/malformed project configuration or installation record cannot guarantee restore. Preserve available data, run local `npx robisie doctor` and follow its advice; new init cannot reconstruct a missing record. Resolve record or key-read errors before network errors. Never replace a damaged record with an empty one.
244
266
 
245
- Follow four steps; the table is a reference for selecting files, not twenty mandatory copies:
267
+ Follow four steps; the command pairs below are a reference for selecting files, not twenty mandatory copies:
246
268
 
247
269
  1. Preserve project manifests (`package.json` and `package-lock.json`), project configuration and robisie’s installation record/key. Record absent files in `absent.txt`.
248
270
  2. From `manifest.entries`, select only installed providers, the recorded profile, roles and prior backups. Apply all path, type and readability checks below.
249
271
  3. Make and check only those copies; retain their paths and the selected release tgz privately.
250
272
  4. Update only after the copies are complete. To restore, compare later changes and restore BOTH project manifests before the tgz command, then load the key → install tgz → init → doctor.
251
273
 
252
- The table contains separate commands for manual selection, not a block to run wholesale. Copy project and robisie files and only the providers used in the record, never all of `~/.claude/`, CODEX_HOME or the OpenCode directory. Before each command check the type and readability of source, destination and their ancestors. For `backups/` and `roles/codex/`, inspect every child as well. An unreadable file/entry or a symlink (including dangling links and linked ancestors) stops the recipe: preserve state and compare paths, never blindly cp through a link. A directory where a file is expected also needs investigation. If a file is absent, record its full path in `$backup/absent.txt`, e.g. `printf '%s\n' "$PWD/robisie.config.json" >> "$backup/absent.txt"`; skip cp in both directions. Do not delete files created later during restore.
253
-
254
- Set `profile` to the profile actually changed in manifest.entries: zsh `${ZDOTDIR:-$HOME}/.zshrc`; bash on macOS the first readable `$HOME/.bash_profile`, `$HOME/.bash_login`, `$HOME/.profile` (fallback `.bash_profile`); bash elsewhere `$HOME/.bashrc`. With `--no-shell`/another shell do not invent a profile; still preserve a prior profile entry if recorded. For each additional `path` and `backup` in entries, set `entry_path` to the exact absolute path, choose a unique numeric `entry_id`, and record that pair privately. Repeat the last row for every such file. Do not assume defaults cover prior installations or providers. Create only needed missing destination directories after the same path checks.
255
-
256
- | Source → private copy (before update) | Copy → restore destination (only after comparison) |
257
- |---|---|
258
- | `cp -p -- "$PWD/package.json" "$backup/project/package.json"` | `cp -p -- "$backup/project/package.json" "$PWD/package.json"` |
259
- | `cp -p -- "$PWD/package-lock.json" "$backup/project/package-lock.json"` | `cp -p -- "$backup/project/package-lock.json" "$PWD/package-lock.json"` |
260
- | `cp -p -- "$PWD/robisie.config.json" "$backup/project/robisie.config.json"` | `cp -p -- "$backup/project/robisie.config.json" "$PWD/robisie.config.json"` |
261
- | `cp -p -- "$config_home/robisie/key" "$backup/robisie/key"` | `cp -p -- "$backup/robisie/key" "$config_home/robisie/key"` |
262
- | `cp -p -- "$config_home/robisie/manifest.json" "$backup/robisie/manifest.json"` | `cp -p -- "$backup/robisie/manifest.json" "$config_home/robisie/manifest.json"` |
263
- | `cp -Rp -- "$config_home/robisie/backups/." "$backup/robisie/backups/"` | `cp -Rp -- "$backup/robisie/backups/." "$config_home/robisie/backups/"` |
264
- | `cp -Rp -- "$config_home/robisie/roles/codex/." "$backup/robisie/roles/codex/"` | `cp -Rp -- "$backup/robisie/roles/codex/." "$config_home/robisie/roles/codex/"` |
265
- | `cp -p -- "$HOME/.claude.json" "$backup/claude/claude.json"` | `cp -p -- "$backup/claude/claude.json" "$HOME/.claude.json"` |
266
- | `cp -p -- "$HOME/.claude/agents/ceo-client.md" "$backup/claude/agents/ceo-client.md"` | `cp -p -- "$backup/claude/agents/ceo-client.md" "$HOME/.claude/agents/ceo-client.md"` |
267
- | `cp -p -- "$HOME/.claude/agents/manager-builder-client.md" "$backup/claude/agents/manager-builder-client.md"` | `cp -p -- "$backup/claude/agents/manager-builder-client.md" "$HOME/.claude/agents/manager-builder-client.md"` |
268
- | `cp -p -- "$HOME/.claude/agents/quality-officer-client.md" "$backup/claude/agents/quality-officer-client.md"` | `cp -p -- "$backup/claude/agents/quality-officer-client.md" "$HOME/.claude/agents/quality-officer-client.md"` |
269
- | `cp -p -- "$codex_home/config.toml" "$backup/codex/config.toml"` | `cp -p -- "$backup/codex/config.toml" "$codex_home/config.toml"` |
270
- | `cp -p -- "$codex_home/AGENTS.md" "$backup/codex/AGENTS.md"` | `cp -p -- "$backup/codex/AGENTS.md" "$codex_home/AGENTS.md"` |
271
- | `cp -p -- "$config_home/opencode/opencode.json" "$backup/opencode/opencode.json"` | `cp -p -- "$backup/opencode/opencode.json" "$config_home/opencode/opencode.json"` |
272
- | `cp -p -- "$config_home/opencode/agents/ceo-client.md" "$backup/opencode/agents/ceo-client.md"` | `cp -p -- "$backup/opencode/agents/ceo-client.md" "$config_home/opencode/agents/ceo-client.md"` |
273
- | `cp -p -- "$config_home/opencode/agents/manager-builder-client.md" "$backup/opencode/agents/manager-builder-client.md"` | `cp -p -- "$backup/opencode/agents/manager-builder-client.md" "$config_home/opencode/agents/manager-builder-client.md"` |
274
- | `cp -p -- "$config_home/opencode/agents/quality-officer-client.md" "$backup/opencode/agents/quality-officer-client.md"` | `cp -p -- "$backup/opencode/agents/quality-officer-client.md" "$config_home/opencode/agents/quality-officer-client.md"` |
275
- | `cp -p -- "$config_home/opencode/plugins/robisie-review-guard.js" "$backup/opencode/plugins/robisie-review-guard.js"` | `cp -p -- "$backup/opencode/plugins/robisie-review-guard.js" "$config_home/opencode/plugins/robisie-review-guard.js"` |
276
- | `cp -p -- "$profile" "$backup/profile/selected"` | `cp -p -- "$backup/profile/selected" "$profile"` |
277
- | `cp -p -- "$entry_path" "$backup/entries/$entry_id"` | `cp -p -- "$backup/entries/$entry_id" "$entry_path"` |
274
+ The blocks below contain separate commands for manual selection, not a block to run wholesale. Copy project and robisie files and only the providers used in the record, never all of `~/.claude/`, CODEX_HOME or the OpenCode directory. Before each command check the type and readability of source, destination and their ancestors. For `backups/` and `roles/codex/`, inspect every child as well. An unreadable file/entry or a symlink (including dangling links and linked ancestors) stops the recipe: preserve state and compare paths, never blindly cp through a link. A directory where a file is expected also needs investigation. If a file is absent, record its full path in `$backup/absent.txt`, e.g. `printf '%s\n' "$PWD/robisie.config.json" >> "$backup/absent.txt"`; skip cp in both directions. Do not delete files created later during restore.
275
+
276
+ Set `profile` to the profile actually changed in manifest.entries: zsh `${ZDOTDIR:-$HOME}/.zshrc`; bash on macOS the first readable `$HOME/.bash_profile`, `$HOME/.bash_login`, `$HOME/.profile` (fallback `.bash_profile`); bash elsewhere `$HOME/.bashrc`. With `--no-shell`/another shell do not invent a profile; still preserve a prior profile entry if recorded. For each additional `path` and `backup` in entries, set `entry_path` to the exact absolute path, choose a unique numeric `entry_id`, and record that pair privately. Repeat the entry_path pair for every such file. Do not assume defaults cover prior installations or providers. Create only needed missing destination directories after the same path checks.
277
+
278
+ Copy: select only the required commands, checking each result.
279
+
280
+ ```sh
281
+ cp -p -- "$PWD/package.json" "$backup/project/package.json"
282
+ cp -p -- "$PWD/package-lock.json" "$backup/project/package-lock.json"
283
+ cp -p -- "$PWD/robisie.config.json" "$backup/project/robisie.config.json"
284
+ cp -p -- "$config_home/robisie/key" "$backup/robisie/key"
285
+ cp -p -- "$config_home/robisie/manifest.json" "$backup/robisie/manifest.json"
286
+ cp -Rp -- "$config_home/robisie/backups/." "$backup/robisie/backups/"
287
+ cp -Rp -- "$config_home/robisie/roles/codex/." "$backup/robisie/roles/codex/"
288
+ cp -p -- "$HOME/.claude.json" "$backup/claude/claude.json"
289
+ cp -p -- "$HOME/.claude/agents/ceo-client.md" "$backup/claude/agents/ceo-client.md"
290
+ cp -p -- "$HOME/.claude/agents/manager-builder-client.md" "$backup/claude/agents/manager-builder-client.md"
291
+ cp -p -- "$HOME/.claude/agents/quality-officer-client.md" "$backup/claude/agents/quality-officer-client.md"
292
+ cp -p -- "$codex_home/config.toml" "$backup/codex/config.toml"
293
+ cp -p -- "$codex_home/AGENTS.md" "$backup/codex/AGENTS.md"
294
+ cp -p -- "$config_home/opencode/opencode.json" "$backup/opencode/opencode.json"
295
+ cp -p -- "$config_home/opencode/agents/ceo-client.md" "$backup/opencode/agents/ceo-client.md"
296
+ cp -p -- "$config_home/opencode/agents/manager-builder-client.md" "$backup/opencode/agents/manager-builder-client.md"
297
+ cp -p -- "$config_home/opencode/agents/quality-officer-client.md" "$backup/opencode/agents/quality-officer-client.md"
298
+ cp -p -- "$config_home/opencode/plugins/robisie-review-guard.js" "$backup/opencode/plugins/robisie-review-guard.js"
299
+ cp -p -- "$profile" "$backup/profile/selected"
300
+ cp -p -- "$entry_path" "$backup/entries/$entry_id"
301
+ ```
302
+
303
+ Restore: the same source/copy pairs in the same order, only after comparison.
304
+
305
+ ```sh
306
+ cp -p -- "$backup/project/package.json" "$PWD/package.json"
307
+ cp -p -- "$backup/project/package-lock.json" "$PWD/package-lock.json"
308
+ cp -p -- "$backup/project/robisie.config.json" "$PWD/robisie.config.json"
309
+ cp -p -- "$backup/robisie/key" "$config_home/robisie/key"
310
+ cp -p -- "$backup/robisie/manifest.json" "$config_home/robisie/manifest.json"
311
+ cp -Rp -- "$backup/robisie/backups/." "$config_home/robisie/backups/"
312
+ cp -Rp -- "$backup/robisie/roles/codex/." "$config_home/robisie/roles/codex/"
313
+ cp -p -- "$backup/claude/claude.json" "$HOME/.claude.json"
314
+ cp -p -- "$backup/claude/agents/ceo-client.md" "$HOME/.claude/agents/ceo-client.md"
315
+ cp -p -- "$backup/claude/agents/manager-builder-client.md" "$HOME/.claude/agents/manager-builder-client.md"
316
+ cp -p -- "$backup/claude/agents/quality-officer-client.md" "$HOME/.claude/agents/quality-officer-client.md"
317
+ cp -p -- "$backup/codex/config.toml" "$codex_home/config.toml"
318
+ cp -p -- "$backup/codex/AGENTS.md" "$codex_home/AGENTS.md"
319
+ cp -p -- "$backup/opencode/opencode.json" "$config_home/opencode/opencode.json"
320
+ cp -p -- "$backup/opencode/agents/ceo-client.md" "$config_home/opencode/agents/ceo-client.md"
321
+ cp -p -- "$backup/opencode/agents/manager-builder-client.md" "$config_home/opencode/agents/manager-builder-client.md"
322
+ cp -p -- "$backup/opencode/agents/quality-officer-client.md" "$config_home/opencode/agents/quality-officer-client.md"
323
+ cp -p -- "$backup/opencode/plugins/robisie-review-guard.js" "$config_home/opencode/plugins/robisie-review-guard.js"
324
+ cp -p -- "$backup/profile/selected" "$profile"
325
+ cp -p -- "$backup/entries/$entry_id" "$entry_path"
326
+ ```
278
327
 
279
328
  Once the tgz and selected copies are ready, update. Init does not read the key file automatically: ROBISIE_KEY takes priority, then the hidden terminal prompt, then explicit `--key-stdin` (for example automation without a terminal). A key file alone is insufficient. Load the old key BEFORE init/doctor using the same XDG_CONFIG_HOME; separate assignment before export and `&&` retain read failures without printing the key:
280
329
 
@@ -305,9 +354,9 @@ Doctor checks the contract MAJOR; exit 0 also requires its other checks. Choose
305
354
 
306
355
  ### Return to the previous release
307
356
 
308
- Before overwriting, preserve later user edits in a NEW private copy (`umask 077`, e.g. `later="$(mktemp -d "$HOME/robisie-later.XXXXXX")"`). Repeat directory preparation and the left column, substituting `$later` for `$backup`, without altering the original backup. Compare locally and merge user edits with the previous release's copy; configuration can contain a key, so do not publish the diff. Stop overwriting for unreadable configuration, links or an unresolved comparison. There is no promise of automatic rollback.
357
+ Before overwriting, preserve later user edits in a NEW private copy (`umask 077`, e.g. `later="$(mktemp -d "$HOME/robisie-later.XXXXXX")"`). Repeat directory preparation and the copy block, substituting `$later` for `$backup`, without altering the original backup. Compare locally and merge user edits with the previous release's copy; configuration can contain a key, so do not publish the diff. Stop overwriting for unreadable configuration, links or an unresolved comparison. There is no promise of automatic rollback.
309
358
 
310
- After comparison run the selected right-column commands to the same destinations, honoring absent.txt. Directory rows copy contents through `/.` without nesting another directory; before restore prepare checked destination directories if missing. When merging `backups/` and `roles/codex/`, do not delete additional later files. Restore `package.json` AND `package-lock.json` first. Then in the same cwd load the restored old key into ENV, install the retained compatible tgz, and only then run init and doctor:
359
+ After comparison run the selected restore-block commands to the same destinations, honoring absent.txt. Directory commands copy contents through `/.` without nesting another directory; before restore prepare checked destination directories if missing. When merging `backups/` and `roles/codex/`, do not delete additional later files. Restore `package.json` AND `package-lock.json` first. Then in the same cwd load the restored old key into ENV, install the retained compatible tgz, and only then run init and doctor:
311
360
 
312
361
  <!-- restore:start -->
313
362
  ```sh
@@ -334,7 +383,7 @@ npx robisie doctor
334
383
 
335
384
  The `--no-save` option preserves the restored `package.json` and `package-lock.json` without recording a `file:` dependency on the private backup path.
336
385
 
337
- Check the status of every separate table command; any error stops the recipe. The chain stops automatically. Never mask reads or combine key assignment with export. On failure preserve both copies and follow doctor before further overwrites.
386
+ Check the status of every separately selected command; any error stops the recipe. The chain stops automatically. Never mask reads or combine key assignment with export. On failure preserve both copies and follow doctor before further overwrites.
338
387
 
339
388
  <!-- sekcja: odinstalowanie -->
340
389
  ## Uninstall
@@ -355,17 +404,24 @@ Without an installation, begin with the account and Connect → init; repeating
355
404
 
356
405
  CLI messages remain in Polish. Match the message, then follow the English explanation:
357
406
 
358
- | ID | CLI message | Next step |
359
- |---|---|---|
360
- | brak-klucza | `Brak klucza robisie.` | No key: generate one in Connect and supply it to init. |
361
- | odrzucony-klucz | `Serwer robisie odrzucił klucz (nieważny albo unieważniony).` | Generate a new worker key; in zsh/bash run `unset ROBISIE_KEY`, then init with the hidden prompt. |
362
- | brak-odczytu | `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).` | Select worker in Connect; `unset ROBISIE_KEY`, then init with the hidden prompt. |
363
- | major | `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.1.3 (obsługuje 1.x).` | Example of a MAJOR mismatch: install a release compatible with the server contract. |
364
- | brak-env | `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.` | Check profile support; with --no-shell/another shell load the key file into the session environment as shown in init, then doctor. |
365
- | brak-programu | `katalog jest, programu nie ma w PATH` | Install the named provider program or add it to PATH; a configuration directory alone is insufficient. |
366
- | brak-programu-i-katalogu | `brak programu w PATH i katalogu dostawcy` | Install the selected program, repeat init with the complete shared map and doctor. |
367
- | jsonc | `nie zmieniam automatycznie` | Preserve JSONC; prepare supported JSON or choose another provider for all roles. Remote MCP alone is insufficient. |
368
- | niepelna-instalacja | `Claude Code: niepełna instalacja` | Example of missing configuration: repeat init for your agent. |
407
+ - **brak-klucza** — `Brak klucza robisie.`
408
+ No key: generate one in Connect and supply it to init.
409
+ - **odrzucony-klucz** — `Serwer robisie odrzucił klucz (nieważny albo unieważniony).`
410
+ Generate a new worker key; in zsh/bash run `unset ROBISIE_KEY`, then init with the hidden prompt.
411
+ - **brak-odczytu** — `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).`
412
+ Select worker in Connect; `unset ROBISIE_KEY`, then init with the hidden prompt.
413
+ - **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.1.4 (obsługuje 1.x).`
414
+ Example of a MAJOR mismatch: install a release compatible with the server contract.
415
+ - **brak-env** — `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.`
416
+ Check profile support; with --no-shell/another shell load the key file into the session environment as shown in init, then doctor.
417
+ - **brak-programu** — `katalog jest, programu nie ma w PATH`
418
+ Install the named provider program or add it to PATH; a configuration directory alone is insufficient.
419
+ - **brak-programu-i-katalogu** — `brak programu w PATH i katalogu dostawcy`
420
+ Install the selected program, repeat init with the complete shared map and doctor.
421
+ - **jsonc** — `nie zmieniam automatycznie`
422
+ Preserve JSONC; prepare supported JSON or choose another provider for all roles. Remote MCP alone is insufficient.
423
+ - **niepelna-instalacja** — `Claude Code: niepełna instalacja`
424
+ Example of missing configuration: repeat init for your agent.
369
425
 
370
426
  After repair with an existing record, load the saved key as shown in Update before local `npx robisie init` and `npx robisie doctor`; reinstall missing package files from npm, and obtain a compatible release for MAJOR. For a missing record preserve data and follow doctor instead of blindly running init. If the problem remains, send the team the message, version and cwd without the key. Uninstall success means removed entries and exit 0; exit 1 needs the indicated repair and does not mean complete removal.
371
427
 
package/docs/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # robisie — od konta do odebranej karty (paczka 0.1.3)
1
+ # robisie — od konta do odebranej karty (paczka 0.1.4)
2
2
 
3
3
  English: [README.en.md](README.en.md).
4
4
 
@@ -11,7 +11,7 @@ Konto i klucz są potrzebne do init i pracy ról. Osobne wejście to walidacja o
11
11
 
12
12
  Zainstaluj robisie z npm w przygotowanym katalogu; w nim uruchamiaj dalsze polecenia i sesje agentów. [Przygotowanie](#wymagania) → [konto](#konto) → [klucz](#klucz) → [instalacja](#instalacja) → [odbiór](#recenzja-i-odbior).
13
13
 
14
- Wpis CHANGELOG o readback README z rejestru opisuje kontrolę wydania, nie dowód niepustego README konkretnej publikacji. E4 wykazał pusty README w rejestrze przy przewodnikach obecnych w tarballu; lokalnie użyj `node_modules/robisie/docs/`. Metadane rejestru, publikacja i korekta historii CHANGELOG wymagają osobnej pracy wydaniowej.
14
+ Jeśli README w rejestrze jest puste, użyj lokalnych przewodników w `node_modules/robisie/docs/`. Metadane rejestru i publikacja wymagają osobnej pracy wydaniowej.
15
15
 
16
16
  <!-- sekcja: wymagania -->
17
17
  <a id="wymagania"></a>
@@ -27,13 +27,19 @@ Przygotuj pusty katalog na dysku. Nie potrzebujesz strony ani własnego pliku `p
27
27
 
28
28
  Człowiek loguje się na https://robisie.app przez Google albo link e-mail. Zaczekaj na ekran gotowości pierwszego projektu. Przy braku gotowości użyj odnośnika do https://robisie.app/dashboard/plugins/planer i przygotuj projekt w panelu; liczba prób sprawdzania gotowości nie jest gwarancją czasu przygotowania.
29
29
 
30
- Discovery to uwierzytelniony odczyt aktywnych projektów przez `list_projects`; klucz wyznacza, co agent widzi. CEO wymaga, aby uwierzytelnione discovery zwróciło dokładnie jeden projekt. Projekt w panelu nie jest katalogiem na dysku: przed pracą potwierdź z CEO, że dotyczą tego samego celu. Przy zerze projektów człowiek sprawdza gotowość i fallback panelu; przy wielu porządkuje/archiwizuje nadmiarowe projekty, aż discovery zwróci jeden. Wybór kliknięciem w panelu nie wiąże projektu dla CEO. Nie podawaj UUID projektu w rozmowie; CEO bierze identyfikator wyłącznie z discovery. Wynik: jeden rozpoznany projekt, zanim agent zapisze cokolwiek.
30
+ Odczyt projektów to uwierzytelniony odczyt aktywnych projektów przez `list_projects`; klucz wyznacza, co agent widzi. CEO wymaga, aby uwierzytelnione `list_projects` zwróciło dokładnie jeden projekt. Projekt w panelu nie jest katalogiem na dysku: przed pracą potwierdź z CEO, że dotyczą tego samego celu. Przy zerze projektów człowiek sprawdza gotowość i fallback panelu; przy wielu porządkuje/archiwizuje nadmiarowe projekty, aż `list_projects` zwróci jeden. Wybór kliknięciem w panelu nie wiąże projektu dla CEO. Nie podawaj UUID projektu w rozmowie; CEO bierze identyfikator wyłącznie z `list_projects`. Wynik: jeden rozpoznany projekt, zanim agent zapisze cokolwiek.
31
31
 
32
32
  <!-- sekcja: klucz -->
33
33
  <a id="klucz"></a>
34
34
  ## Klucz w Connect
35
35
 
36
- Agent może sam założyć konto i wygenerować klucz na własnym koncie, w granicach zgody jego właściciela. Logowanie lub inny chroniony krok może wymagać potwierdzenia człowieka; po nim kontynuuj. Cudza otwarta sesja nie uprawnia do korzystania z jej konta ani klucza. Sekret pozostaje poza rozmową i historią poleceń; jeśli dostępne narzędzia nie pozwalają przekazać go bezpiecznie, człowiek wpisuje go w ukrytym pytaniu init.
36
+ <!-- agent-consent:start -->
37
+ ### Instrukcja dla agenta — jedna zgoda na przebieg
38
+
39
+ 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ę.
40
+
41
+ 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.
42
+ <!-- agent-consent:end -->
37
43
 
38
44
  Człowiek w https://robisie.app/dashboard/connect wybiera `worker` i własną rozpoznawalną etykietę, np. „tester laptop”, następnie generuje klucz. Jest wyświetlany tylko raz: zachowaj go jak hasło. Człowiek przekazuje go poza rozmową do ukrytego pytania init, nigdy do czatu, karty, argumentu polecenia ani historii powłoki.
39
45
 
@@ -45,14 +51,18 @@ Paczka zapisuje **jeden klucz dla CEO, Buildera i Quality Officera** jako `ROBIS
45
51
  <a id="instalacja"></a>
46
52
  ## Instalacja z npm
47
53
 
48
- Po przygotowaniu konta i klucza człowiek otwiera terminal i wchodzi do wybranego pustego katalogu (zastąp przykładową ścieżkę poniżej). Poniższy krok Node.js tworzy lokalny `package.json` niezależnie od nazwy katalogu, także ze spacjami i polskimi znakami. Manifest ustala katalog instalacji także pod przodkiem z `node_modules`. Jeśli ścieżka `package.json` już istnieje (również jako link), krok odmawia zapisu; niczego nie nadpisuje. EEXIST oznacza istniejącą ścieżkę: wybierz drogę istniejącego projektu poniżej; link/katalog wymaga wyjaśnienia. Błąd wejścia do katalogu lub utworzenia manifestu zatrzymuje dalszy blok. Następnie: instalacja, init z ukrytym pytaniem o klucz, doctor. W zsh/bash usuń stary ENV przed init i wczytaj zapisany klucz przed doctor — init nie ustawia środowiska rodzica:
54
+ 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.
55
+
56
+ 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.
57
+
58
+ Po przygotowaniu konta i klucza człowiek otwiera terminal i wchodzi do wybranego pustego katalogu (zastąp przykładową ścieżkę poniżej). Poniższy krok Node.js tworzy lokalny `package.json` niezależnie od nazwy katalogu, także ze spacjami i polskimi znakami. Manifest ustala katalog instalacji także pod przodkiem z `node_modules`. Jeśli ścieżka `package.json` już istnieje (również jako link), krok odmawia zapisu; niczego nie nadpisuje. Błąd wejścia do katalogu lub utworzenia manifestu zatrzymuje dalszy blok. Następnie: instalacja, init z ukrytym pytaniem o klucz, doctor. W zsh/bash usuń stary ENV przed init i wczytaj zapisany klucz przed doctor — init nie ustawia środowiska rodzica:
49
59
 
50
60
  ```sh
51
61
  cd "/ścieżka/do/pustego katalogu" &&
52
62
  node -e 'try {
53
63
  require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
54
64
  } catch (error) {
55
- console.error(error.message);
65
+ 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.");
56
66
  process.exit(1);
57
67
  }' &&
58
68
  {
@@ -78,7 +88,7 @@ npx robisie doctor
78
88
 
79
89
  Łańcuch `&&` zatrzymuje blok po pierwszym błędzie; osobne przypisanie przed `export` zachowuje status odczytu klucza, więc doctor go nie maskuje. Po naprawieniu przyczyny ponów nieudany krok i wszystkie następne z bloku w tym samym katalogu. Jeśli manifest już powstał, nie ponawiaj jego tworzenia ani go nie usuwaj.
80
90
 
81
- Dla istniejącego projektu bez `package.json` wykonaj powyższy blok nowej instalacji w katalogu tego projektu: tworzy tylko prywatny manifest i zachowuje pozostałe pliki. Jeśli zwykły manifest już istnieje albo reinstalujesz z zachowanym poprawnym kluczem, użyj poniższego bloku w wybranym katalogu projektu. Wczytuje zapisany klucz przed npm/init/doctor, nie nadpisuje zwykłego manifestu podczas przygotowania i tworzy go przez `wx` tylko przy braku. Samo npm może następnie dopisać zależność robisie oraz zmienić lockfile. Link manifestu (także wiszący) lub katalog odrzuca z wyjaśnieniem. Po uninstall, gdy nie ma poprawnego klucza, wróć do Connect i ukrytego pytania init: przy istniejącym zwykłym manifeście wykonaj blok nowej instalacji od `set +x` do doctor, bez kroku `cd`/tworzenia manifestu. Nie usuwaj manifestu, żeby ponowić instalację.
91
+ 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ę.
82
92
 
83
93
  <!-- reinstall:start -->
84
94
  ```sh
@@ -190,9 +200,9 @@ Doctor uruchamia plik pomocnika przez node, agent przez npx. `ROBISIE_PROJECT_CO
190
200
  <!-- sekcja: pierwsza-karta -->
191
201
  ## Pierwsza karta i start Buildera
192
202
 
193
- Człowiek uruchamia CEO w katalogu instalacji: `claude --agent ceo-client`, albo `codex` i prosi o rolę robisie CEO (odczyt pełnego pliku wskazanego w AGENTS.md), albo `opencode` i wybiera `ceo-client`. Po poprawnym discovery przekaż prośbę, która działa po instalacji npm z samym README:
203
+ Człowiek uruchamia CEO w katalogu instalacji: `claude --agent ceo-client`, albo `codex` i prosi o rolę robisie CEO (odczyt pełnego pliku wskazanego w AGENTS.md), albo `opencode` i wybiera `ceo-client`. Po poprawnym odczycie projektów przekaż prośbę, która działa po instalacji npm z samym README:
194
204
 
195
- > Utwórz w tym katalogu plik wynik.txt z dokładną treścią „robisie działa” i końcowym znakiem nowej linii. Sprawdź odczytem, że treść jest dokładnie taka. Granice: tylko ten plik, bez zależności, kont i publikacji. Przygotuj zakres i zaczekaj na moją zgodę; po pracy potrzebuję niezależnej recenzji i mojego odbioru.
205
+ > Utwórz w tym katalogu plik wynik.txt z dokładną treścią „robisie działa” i końcowym znakiem nowej linii. Sprawdź odczytem, że treść jest dokładnie taka. Granice: tylko ten plik, bez zależności, kont i publikacji. Korzystaj z mojej wcześniejszej zgody, jeśli obejmuje dokładnie ten zakres; w przeciwnym razie zapytaj przed pracą. Po pracy potrzebuję niezależnej recenzji i osobnego końcowego odbioru.
196
206
 
197
207
  Po zgodzie człowieka CEO domyślnie wywołuje `spawn_builder` z ID karty potwierdzonej w `ready`. Pełny przebieg w Claude Code: `draft` → `ready` → `in_progress` → `in_review` → niezależna recenzja i verified receipt → `delivered` → odbiór właściciela → `done`; granice odbioru dla pozostałych sesji opisuje sekcja [Recenzja i jawny odbiór](#recenzja-i-odbior).
198
208
 
@@ -218,13 +228,25 @@ W Claude Code CEO uruchamia niezależnego Quality Officera przez `Agent(quality-
218
228
 
219
229
  OpenCode: karta pozostaje w `in_review` niezależnie od dostępności narzędzia Agent; brak wspieranego przejścia do `delivered`. Pełny odbiór wymaga opisanej wyżej ścieżki w Claude Code. Wynik task/VERIFIED, etykieta roli ani sam JSON receiptu nie otwierają tego przejścia; nie obchodź odmowy ręczną zmianą statusu ani samorecenzją.
220
230
 
221
- W innych sesjach CEO, w tym Codex, przejście do delivered wymaga niezależnej recenzji oraz zweryfikowanego potwierdzenia (verified receipt). Jeśli w sesji CEO brakuje narzędzia Agent, karta pozostaje w `in_review`: to brak zdolności produktu wymagający naprawy CEO/CR. Nie zastępuj recenzji oceną Buildera ani ręczną zmianą etapu. Sama konfiguracja trzech ról nie zapewnia tej integracji.
231
+ W innych sesjach CEO, w tym Codex, przejście do delivered wymaga niezależnej recenzji oraz zweryfikowanego potwierdzenia (verified receipt). Jeśli w sesji CEO brakuje narzędzia Agent, karta pozostaje w `in_review`: to brak zdolności produktu wymagający naprawy przez osobę odpowiedzialną za integrację CEO. Nie zastępuj recenzji oceną Buildera ani ręczną zmianą etapu. Sama konfiguracja trzech ról nie zapewnia tej integracji.
222
232
 
223
233
  Właściciel projektu może w panelu: Dashboard → Planer → karta → Etap wybrać „Zrobione” i przesunąć `delivered` do `done`, także przy kluczu agenta `worker`. Dla opisanej pierwszej karty serwer nie wymusza zapisanej akceptacji ani dowodów przed zmianą na `done`: panel pozwala właścicielowi wybrać „Zrobione” także bez nich. Zrób to dopiero po sprawdzeniu wyniku i jawnym odbiorze. Panel nie edytuje szczegółów `details`; recenzję i dowody zapisuje się przez obsługiwany przepływ narzędzi tablicy. Sama instrukcja nie dowodzi, że ten przebieg przeszedł już u klienta.
224
234
 
225
235
  <!-- sekcja: aktualizacja -->
226
236
  ## Aktualizacja i prywatna kopia
227
237
 
238
+ ### Aktualizacja przed pierwszym init
239
+
240
+ 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.
241
+
242
+ <!-- before-init-update:start -->
243
+ ```sh
244
+ npm i robisie@latest
245
+ ```
246
+ <!-- before-init-update:end -->
247
+
248
+ ### Aktualizacja po init
249
+
228
250
  Pracuj w katalogu instalacji. Najpierw przygotuj kopię poniżej. Wybierz jawnie poprzednią, zgodną z MAJOR kontraktu serwera wersję; sprawdź zainstalowaną przez `node -p 'require("./node_modules/robisie/package.json").version'`. Przykład `previous_version='0.1.1'` zastąp tą wybraną wersją. `npm pack robisie@<wersja>` pobiera właśnie to wydanie, nie przypadkowy plik tgz; zachowaj jego nazwę i katalog kopii. Nie wykonuj przepisu z włączonym xtrace, nie drukuj ani nie wklejaj sekretów.
229
251
 
230
252
  ```sh
@@ -244,39 +266,66 @@ Zachowaj te same wartości HOME, XDG_CONFIG_HOME i CODEX_HOME co podczas instala
244
266
 
245
267
  Brak/null/pusta/wadliwa konfiguracja projektu lub ewidencja nie daje gwarancji restore. Zachowaj dostępne dane, uruchom lokalny `npx robisie doctor` i zastosuj jego poradę; nowy init nie odtworzy brakującej ewidencji. Przy błędzie ewidencji lub odczytu klucza rozwiąż go przed błędami sieci. Nie zamieniaj uszkodzonej ewidencji na pustą.
246
268
 
247
- Przejdź cztery kroki; tabela to ściąga wyboru plików, nie dwadzieścia obowiązkowych kopii:
269
+ Przejdź cztery kroki; pary poleceń to ściąga wyboru plików, nie dwadzieścia obowiązkowych kopii:
248
270
 
249
271
  1. Zachowaj manifesty projektu (`package.json` i `package-lock.json`), konfigurację projektu oraz ewidencję/klucz robisie. Braki odnotuj w `absent.txt`.
250
272
  2. Z `manifest.entries` wybierz tylko użytych dostawców, zapisany profil, role i wcześniejsze backupy. Zastosuj wszystkie kontrole ścieżek, typu i odczytu opisane poniżej.
251
273
  3. Wykonaj i sprawdź tylko te kopie; zachowaj prywatnie ich ścieżki oraz tgz wybranego wydania.
252
274
  4. Aktualizuj dopiero po wykonaniu kopii. Przy powrocie porównaj późniejsze zmiany i przywróć OBA manifesty projektu przed komendą tgz, potem klucz → instalacja tgz → init → doctor.
253
275
 
254
- Poniższa tabela to osobne komendy do ręcznego wyboru, nie blok do uruchomienia w całości. Kopiuj pliki projektu i robisie oraz tylko użytych dostawców z ewidencji, nigdy całe `~/.claude/`, `CODEX_HOME` ani katalog OpenCode. Dla każdego źródła i celu oraz ich katalogów nadrzędnych sprawdź wcześniej typ i odczyt. Dla `backups/` i `roles/codex/` sprawdź również wszystkie elementy wewnątrz. Nieczytelny plik/wpis lub dowiązanie (także wiszące, również w katalogu nadrzędnym) zatrzymuje przepis: zachowaj stan i porównaj ścieżki, bez ślepego cp przez link. Katalog w miejscu oczekiwanego pliku także wymaga wyjaśnienia. Jeśli pliku nie ma, odnotuj jego pełną ścieżkę w `$backup/absent.txt`, np. `printf '%s\n' "$PWD/robisie.config.json" >> "$backup/absent.txt"`; pomiń cp w obie strony. Przy restore nie kasuj plików, które powstały później.
255
-
256
- `profile` ustaw na faktycznie zmieniony profil z manifest.entries: zsh `${ZDOTDIR:-$HOME}/.zshrc`; bash na macOS pierwszy czytelny `$HOME/.bash_profile`, `$HOME/.bash_login`, `$HOME/.profile` (gdy żaden nie istnieje, `.bash_profile`); bash poza macOS `$HOME/.bashrc`. Przy `--no-shell`/innej powłoce nie dopisuj nowego profilu; zachowaj jednak wcześniejszy wpis profilu, jeśli jest w ewidencji. Każdy dodatkowy `path` i `backup` z entries skopiuj oddzielnie: ustaw `entry_path` na dokładną absolutną ścieżkę, `entry_id` na własny unikalny numer i zanotuj parę w prywatnej kopii. Ostatni wiersz powtórz dla każdego takiego pliku. Nie zakładaj, że lista domyślna pokrywa poprzednie instalacje i dostawców. Utwórz tylko potrzebne brakujące katalogi docelowe po tej samej kontroli ścieżek.
257
-
258
- | Źródło → prywatna kopia (przed aktualizacją) | Kopia → cel restore (dopiero po porównaniu) |
259
- |---|---|
260
- | `cp -p -- "$PWD/package.json" "$backup/project/package.json"` | `cp -p -- "$backup/project/package.json" "$PWD/package.json"` |
261
- | `cp -p -- "$PWD/package-lock.json" "$backup/project/package-lock.json"` | `cp -p -- "$backup/project/package-lock.json" "$PWD/package-lock.json"` |
262
- | `cp -p -- "$PWD/robisie.config.json" "$backup/project/robisie.config.json"` | `cp -p -- "$backup/project/robisie.config.json" "$PWD/robisie.config.json"` |
263
- | `cp -p -- "$config_home/robisie/key" "$backup/robisie/key"` | `cp -p -- "$backup/robisie/key" "$config_home/robisie/key"` |
264
- | `cp -p -- "$config_home/robisie/manifest.json" "$backup/robisie/manifest.json"` | `cp -p -- "$backup/robisie/manifest.json" "$config_home/robisie/manifest.json"` |
265
- | `cp -Rp -- "$config_home/robisie/backups/." "$backup/robisie/backups/"` | `cp -Rp -- "$backup/robisie/backups/." "$config_home/robisie/backups/"` |
266
- | `cp -Rp -- "$config_home/robisie/roles/codex/." "$backup/robisie/roles/codex/"` | `cp -Rp -- "$backup/robisie/roles/codex/." "$config_home/robisie/roles/codex/"` |
267
- | `cp -p -- "$HOME/.claude.json" "$backup/claude/claude.json"` | `cp -p -- "$backup/claude/claude.json" "$HOME/.claude.json"` |
268
- | `cp -p -- "$HOME/.claude/agents/ceo-client.md" "$backup/claude/agents/ceo-client.md"` | `cp -p -- "$backup/claude/agents/ceo-client.md" "$HOME/.claude/agents/ceo-client.md"` |
269
- | `cp -p -- "$HOME/.claude/agents/manager-builder-client.md" "$backup/claude/agents/manager-builder-client.md"` | `cp -p -- "$backup/claude/agents/manager-builder-client.md" "$HOME/.claude/agents/manager-builder-client.md"` |
270
- | `cp -p -- "$HOME/.claude/agents/quality-officer-client.md" "$backup/claude/agents/quality-officer-client.md"` | `cp -p -- "$backup/claude/agents/quality-officer-client.md" "$HOME/.claude/agents/quality-officer-client.md"` |
271
- | `cp -p -- "$codex_home/config.toml" "$backup/codex/config.toml"` | `cp -p -- "$backup/codex/config.toml" "$codex_home/config.toml"` |
272
- | `cp -p -- "$codex_home/AGENTS.md" "$backup/codex/AGENTS.md"` | `cp -p -- "$backup/codex/AGENTS.md" "$codex_home/AGENTS.md"` |
273
- | `cp -p -- "$config_home/opencode/opencode.json" "$backup/opencode/opencode.json"` | `cp -p -- "$backup/opencode/opencode.json" "$config_home/opencode/opencode.json"` |
274
- | `cp -p -- "$config_home/opencode/agents/ceo-client.md" "$backup/opencode/agents/ceo-client.md"` | `cp -p -- "$backup/opencode/agents/ceo-client.md" "$config_home/opencode/agents/ceo-client.md"` |
275
- | `cp -p -- "$config_home/opencode/agents/manager-builder-client.md" "$backup/opencode/agents/manager-builder-client.md"` | `cp -p -- "$backup/opencode/agents/manager-builder-client.md" "$config_home/opencode/agents/manager-builder-client.md"` |
276
- | `cp -p -- "$config_home/opencode/agents/quality-officer-client.md" "$backup/opencode/agents/quality-officer-client.md"` | `cp -p -- "$backup/opencode/agents/quality-officer-client.md" "$config_home/opencode/agents/quality-officer-client.md"` |
277
- | `cp -p -- "$config_home/opencode/plugins/robisie-review-guard.js" "$backup/opencode/plugins/robisie-review-guard.js"` | `cp -p -- "$backup/opencode/plugins/robisie-review-guard.js" "$config_home/opencode/plugins/robisie-review-guard.js"` |
278
- | `cp -p -- "$profile" "$backup/profile/selected"` | `cp -p -- "$backup/profile/selected" "$profile"` |
279
- | `cp -p -- "$entry_path" "$backup/entries/$entry_id"` | `cp -p -- "$backup/entries/$entry_id" "$entry_path"` |
276
+ Poniższe bloki to osobne komendy do ręcznego wyboru, nie blok do uruchomienia w całości. Kopiuj pliki projektu i robisie oraz tylko użytych dostawców z ewidencji, nigdy całe `~/.claude/`, `CODEX_HOME` ani katalog OpenCode. Dla każdego źródła i celu oraz ich katalogów nadrzędnych sprawdź wcześniej typ i odczyt. Dla `backups/` i `roles/codex/` sprawdź również wszystkie elementy wewnątrz. Nieczytelny plik/wpis lub dowiązanie (także wiszące, również w katalogu nadrzędnym) zatrzymuje przepis: zachowaj stan i porównaj ścieżki, bez ślepego cp przez link. Katalog w miejscu oczekiwanego pliku także wymaga wyjaśnienia. Jeśli pliku nie ma, odnotuj jego pełną ścieżkę w `$backup/absent.txt`, np. `printf '%s\n' "$PWD/robisie.config.json" >> "$backup/absent.txt"`; pomiń cp w obie strony. Przy restore nie kasuj plików, które powstały później.
277
+
278
+ `profile` ustaw na faktycznie zmieniony profil z manifest.entries: zsh `${ZDOTDIR:-$HOME}/.zshrc`; bash na macOS pierwszy czytelny `$HOME/.bash_profile`, `$HOME/.bash_login`, `$HOME/.profile` (gdy żaden nie istnieje, `.bash_profile`); bash poza macOS `$HOME/.bashrc`. Przy `--no-shell`/innej powłoce nie dopisuj nowego profilu; zachowaj jednak wcześniejszy wpis profilu, jeśli jest w ewidencji. Każdy dodatkowy `path` i `backup` z entries skopiuj oddzielnie: ustaw `entry_path` na dokładną absolutną ścieżkę, `entry_id` na własny unikalny numer i zanotuj parę w prywatnej kopii. Parę entry_path powtórz dla każdego takiego pliku. Nie zakładaj, że lista domyślna pokrywa poprzednie instalacje i dostawców. Utwórz tylko potrzebne brakujące katalogi docelowe po tej samej kontroli ścieżek.
279
+
280
+ Kopia: wybierz tylko potrzebne polecenia i sprawdź wynik każdego.
281
+
282
+ ```sh
283
+ cp -p -- "$PWD/package.json" "$backup/project/package.json"
284
+ cp -p -- "$PWD/package-lock.json" "$backup/project/package-lock.json"
285
+ cp -p -- "$PWD/robisie.config.json" "$backup/project/robisie.config.json"
286
+ cp -p -- "$config_home/robisie/key" "$backup/robisie/key"
287
+ cp -p -- "$config_home/robisie/manifest.json" "$backup/robisie/manifest.json"
288
+ cp -Rp -- "$config_home/robisie/backups/." "$backup/robisie/backups/"
289
+ cp -Rp -- "$config_home/robisie/roles/codex/." "$backup/robisie/roles/codex/"
290
+ cp -p -- "$HOME/.claude.json" "$backup/claude/claude.json"
291
+ cp -p -- "$HOME/.claude/agents/ceo-client.md" "$backup/claude/agents/ceo-client.md"
292
+ cp -p -- "$HOME/.claude/agents/manager-builder-client.md" "$backup/claude/agents/manager-builder-client.md"
293
+ cp -p -- "$HOME/.claude/agents/quality-officer-client.md" "$backup/claude/agents/quality-officer-client.md"
294
+ cp -p -- "$codex_home/config.toml" "$backup/codex/config.toml"
295
+ cp -p -- "$codex_home/AGENTS.md" "$backup/codex/AGENTS.md"
296
+ cp -p -- "$config_home/opencode/opencode.json" "$backup/opencode/opencode.json"
297
+ cp -p -- "$config_home/opencode/agents/ceo-client.md" "$backup/opencode/agents/ceo-client.md"
298
+ cp -p -- "$config_home/opencode/agents/manager-builder-client.md" "$backup/opencode/agents/manager-builder-client.md"
299
+ cp -p -- "$config_home/opencode/agents/quality-officer-client.md" "$backup/opencode/agents/quality-officer-client.md"
300
+ cp -p -- "$config_home/opencode/plugins/robisie-review-guard.js" "$backup/opencode/plugins/robisie-review-guard.js"
301
+ cp -p -- "$profile" "$backup/profile/selected"
302
+ cp -p -- "$entry_path" "$backup/entries/$entry_id"
303
+ ```
304
+
305
+ Przywracanie: te same pary źródło/kopia w tej samej kolejności, dopiero po porównaniu.
306
+
307
+ ```sh
308
+ cp -p -- "$backup/project/package.json" "$PWD/package.json"
309
+ cp -p -- "$backup/project/package-lock.json" "$PWD/package-lock.json"
310
+ cp -p -- "$backup/project/robisie.config.json" "$PWD/robisie.config.json"
311
+ cp -p -- "$backup/robisie/key" "$config_home/robisie/key"
312
+ cp -p -- "$backup/robisie/manifest.json" "$config_home/robisie/manifest.json"
313
+ cp -Rp -- "$backup/robisie/backups/." "$config_home/robisie/backups/"
314
+ cp -Rp -- "$backup/robisie/roles/codex/." "$config_home/robisie/roles/codex/"
315
+ cp -p -- "$backup/claude/claude.json" "$HOME/.claude.json"
316
+ cp -p -- "$backup/claude/agents/ceo-client.md" "$HOME/.claude/agents/ceo-client.md"
317
+ cp -p -- "$backup/claude/agents/manager-builder-client.md" "$HOME/.claude/agents/manager-builder-client.md"
318
+ cp -p -- "$backup/claude/agents/quality-officer-client.md" "$HOME/.claude/agents/quality-officer-client.md"
319
+ cp -p -- "$backup/codex/config.toml" "$codex_home/config.toml"
320
+ cp -p -- "$backup/codex/AGENTS.md" "$codex_home/AGENTS.md"
321
+ cp -p -- "$backup/opencode/opencode.json" "$config_home/opencode/opencode.json"
322
+ cp -p -- "$backup/opencode/agents/ceo-client.md" "$config_home/opencode/agents/ceo-client.md"
323
+ cp -p -- "$backup/opencode/agents/manager-builder-client.md" "$config_home/opencode/agents/manager-builder-client.md"
324
+ cp -p -- "$backup/opencode/agents/quality-officer-client.md" "$config_home/opencode/agents/quality-officer-client.md"
325
+ cp -p -- "$backup/opencode/plugins/robisie-review-guard.js" "$config_home/opencode/plugins/robisie-review-guard.js"
326
+ cp -p -- "$backup/profile/selected" "$profile"
327
+ cp -p -- "$backup/entries/$entry_id" "$entry_path"
328
+ ```
280
329
 
281
330
  Gdy tgz i wszystkie wybrane kopie są gotowe, aktualizuj. Init nie czyta pliku key automatycznie: pierwszeństwo ma ROBISIE_KEY, potem ukryte pytanie w terminalu, potem jawny `--key-stdin` (np. automatyzacja bez terminala). Sam plik key nie wystarcza. Wczytaj stary klucz PRZED init/doctor z tego samego XDG_CONFIG_HOME; osobne przypisanie przed export i `&&` zachowują błąd odczytu bez wydruku klucza:
282
331
 
@@ -307,9 +356,9 @@ Doctor sprawdza MAJOR kontraktu; exit 0 wymaga także pozostałych kontroli. Prz
307
356
 
308
357
  ### Powrót do poprzedniego wydania
309
358
 
310
- Przed nadpisaniem zachowaj późniejsze własne zmiany w NOWEJ prywatnej kopii (`umask 077`, np. `later="$(mktemp -d "$HOME/robisie-later.XXXXXX")"`). Powtórz przygotowanie katalogów i lewą kolumnę, podstawiając `$later` zamiast `$backup`, bez zmiany starej kopii. Porównaj lokalnie i scal własne zmiany z kopią poprzedniego wydania; konfiguracja może zawierać klucz, więc bez publikowania diffu. Przy nieczytelnej konfiguracji, linku lub nierozstrzygniętym porównaniu przerwij nadpisywanie. Nie ma obietnicy automatycznego rollbacku.
359
+ Przed nadpisaniem zachowaj późniejsze własne zmiany w NOWEJ prywatnej kopii (`umask 077`, np. `later="$(mktemp -d "$HOME/robisie-later.XXXXXX")"`). Powtórz przygotowanie katalogów i blok kopii, podstawiając `$later` zamiast `$backup`, bez zmiany starej kopii. Porównaj lokalnie i scal własne zmiany z kopią poprzedniego wydania; konfiguracja może zawierać klucz, więc bez publikowania diffu. Przy nieczytelnej konfiguracji, linku lub nierozstrzygniętym porównaniu przerwij nadpisywanie. Nie ma obietnicy automatycznego rollbacku.
311
360
 
312
- Po porównaniu wykonaj wybrane komendy z prawej kolumny do tych samych celów, zachowując pominięcia z absent.txt. Wiersze katalogów kopiują zawartość przez `/.`, bez zagnieżdżania kolejnego katalogu; przed restore przygotuj sprawdzone katalogi celów, jeśli ich brakuje. Przy scalaniu `backups/` i `roles/codex/` nie usuwaj dodatkowych późniejszych plików. Najpierw przywróć `package.json` ORAZ `package-lock.json`. Potem w tym samym cwd wczytaj przywrócony stary klucz do ENV, zainstaluj zachowany zgodny tgz i dopiero wykonaj init oraz doctor:
361
+ Po porównaniu wykonaj wybrane komendy z bloku przywracania do tych samych celów, zachowując pominięcia z absent.txt. Polecenia katalogów kopiują zawartość przez `/.`, bez zagnieżdżania kolejnego katalogu; przed restore przygotuj sprawdzone katalogi celów, jeśli ich brakuje. Przy scalaniu `backups/` i `roles/codex/` nie usuwaj dodatkowych późniejszych plików. Najpierw przywróć `package.json` ORAZ `package-lock.json`. Potem w tym samym cwd wczytaj przywrócony stary klucz do ENV, zainstaluj zachowany zgodny tgz i dopiero wykonaj init oraz doctor:
313
362
 
314
363
  <!-- restore:start -->
315
364
  ```sh
@@ -336,7 +385,7 @@ npx robisie doctor
336
385
 
337
386
  Opcja `--no-save` zachowuje przywrócone `package.json` i `package-lock.json`, bez zapisywania zależności `file:` od ścieżki prywatnej kopii.
338
387
 
339
- Po każdej osobnej komendzie tabeli sprawdź jej status; błąd zatrzymuje przepis. Łańcuch zatrzymuje się sam. Nie maskuj odczytu ani nie łącz przypisania klucza z export. W razie błędu zachowaj obie kopie i skorzystaj z porady doctor, bez dalszego nadpisywania.
388
+ Po każdej osobnej wybranej komendzie sprawdź jej status; błąd zatrzymuje przepis. Łańcuch zatrzymuje się sam. Nie maskuj odczytu ani nie łącz przypisania klucza z export. W razie błędu zachowaj obie kopie i skorzystaj z porady doctor, bez dalszego nadpisywania.
340
389
 
341
390
  <!-- sekcja: odinstalowanie -->
342
391
  ## Odinstalowanie
@@ -357,17 +406,24 @@ Bez instalacji zacznij od konta i Connect → init; samo ponawianie doctor nie z
357
406
 
358
407
  Komunikaty CLI pozostają po polsku. Dopasuj komunikat, a potem wykonaj wskazaną czynność:
359
408
 
360
- | ID | Komunikat CLI | Następny krok |
361
- |---|---|---|
362
- | brak-klucza | `Brak klucza robisie.` | Wygeneruj klucz w Connect i przekaż go do init. |
363
- | odrzucony-klucz | `Serwer robisie odrzucił klucz (nieważny albo unieważniony).` | Wygeneruj nowy klucz worker; w zsh/bash wykonaj `unset ROBISIE_KEY`, potem init z ukrytym pytaniem. |
364
- | brak-odczytu | `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).` | Wybierz worker w Connect; `unset ROBISIE_KEY`, potem init z ukrytym pytaniem. |
365
- | major | `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.1.3 (obsługuje 1.x).` | Przykład niezgodnego MAJOR: zainstaluj wydanie zgodne z kontraktem serwera. |
366
- | brak-env | `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.` | Sprawdź obsługę profilu; przy --no-shell/innej powłoce wczytaj plik klucza do środowiska sesji jak w init, potem doctor. |
367
- | brak-programu | `katalog jest, programu nie ma w PATH` | Zainstaluj program wskazanego dostawcy lub dodaj go do PATH; sam katalog konfiguracji nie wystarcza. |
368
- | brak-programu-i-katalogu | `brak programu w PATH i katalogu dostawcy` | Zainstaluj wybrany program, ponów init z pełną wspólną mapą i doctor. |
369
- | jsonc | `nie zmieniam automatycznie` | Zachowaj JSONC; przygotuj wspierany JSON albo wybierz innego dostawcę dla wszystkich ról. Sam zdalny MCP nie wystarcza. |
370
- | niepelna-instalacja | `Claude Code: niepełna instalacja` | Przykład brakującej konfiguracji: ponów init dla swojego agenta. |
409
+ - **brak-klucza** — `Brak klucza robisie.`
410
+ Wygeneruj klucz w Connect i przekaż go do init.
411
+ - **odrzucony-klucz** — `Serwer robisie odrzucił klucz (nieważny albo unieważniony).`
412
+ Wygeneruj nowy klucz worker; w zsh/bash wykonaj `unset ROBISIE_KEY`, potem init z ukrytym pytaniem.
413
+ - **brak-odczytu** — `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).`
414
+ Wybierz worker w Connect; `unset ROBISIE_KEY`, potem init z ukrytym pytaniem.
415
+ - **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.1.4 (obsługuje 1.x).`
416
+ Przykład niezgodnego MAJOR: zainstaluj wydanie zgodne z kontraktem serwera.
417
+ - **brak-env** — `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.`
418
+ Sprawdź obsługę profilu; przy --no-shell/innej powłoce wczytaj plik klucza do środowiska sesji jak w init, potem doctor.
419
+ - **brak-programu** — `katalog jest, programu nie ma w PATH`
420
+ Zainstaluj program wskazanego dostawcy lub dodaj go do PATH; sam katalog konfiguracji nie wystarcza.
421
+ - **brak-programu-i-katalogu** — `brak programu w PATH i katalogu dostawcy`
422
+ Zainstaluj wybrany program, ponów init z pełną wspólną mapą i doctor.
423
+ - **jsonc** — `nie zmieniam automatycznie`
424
+ Zachowaj JSONC; przygotuj wspierany JSON albo wybierz innego dostawcę dla wszystkich ról. Sam zdalny MCP nie wystarcza.
425
+ - **niepelna-instalacja** — `Claude Code: niepełna instalacja`
426
+ Przykład brakującej konfiguracji: ponów init dla swojego agenta.
371
427
 
372
428
  Po naprawie przy istniejącej ewidencji wczytaj zapisany klucz według Aktualizacji przed lokalnym `npx robisie init` i `npx robisie doctor`; przy braku plików paczki przeinstaluj ją z npm, przy MAJOR uzyskaj zgodne wydanie. Przy braku ewidencji zachowaj dane i zastosuj poradę doctor zamiast init w ciemno. Jeśli problem pozostaje, przekaż zespołowi komunikat, wersję i cwd bez klucza. Przy uninstall wynik to usunięte wpisy i exit 0; kod 1 wymaga wskazanej naprawy, nie oznacza pełnego usunięcia.
373
429
 
@@ -88,9 +88,11 @@ export const config = parseConfig({
88
88
  - `dist/role-registry.js`
89
89
  - `dist/role-results.js`
90
90
  - `dist/roles.js`
91
+ - `dist/seed-package.js`
91
92
  - `dist/seed-validation.js`
92
93
  - `dist/selection-result.js`
93
94
  - `dist/sparse-policy.js`
95
+ - `dist/task-mktemp.js`
94
96
  - `dist/tester-identity.js`
95
97
  - `dist/worker-env.js`
96
98
  - `helpers/ceo-client-launcher-mcp.mjs` → `spawn_builder`
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "robisie",
3
- "version": "0.1.3",
3
+ "version": "0.1.4",
4
4
  "description": "Instalator klienta robisie: łączy agenta (Claude Code, Codex CLI, OpenCode) z tablicą robisie i instaluje role klienta.",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",