robisie 0.2.2 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -12,7 +12,13 @@ export interface Manifest {
12
12
  entries: Entry[];
13
13
  /** Kept raw so doctor and uninstall can still inspect entries when the map is damaged. */
14
14
  roleProviders?: unknown;
15
+ /** Set by `npx robisie login` (CONTRACT §7.3 J5, §7.6): A and B then come from the key files, never from ENV. */
16
+ installation_id?: string;
17
+ pair_id?: string;
18
+ credentialSource?: "login";
15
19
  }
20
+ /** The login fields a rewrite of the manifest must carry forward. */
21
+ export declare function loginFields(manifest: Manifest | null): Pick<Manifest, "installation_id" | "pair_id" | "credentialSource">;
16
22
  export declare const ROLE_IDS: readonly ["ceo", "builder", "quality"];
17
23
  export type RoleProviders = Record<RoleKind, AgentId>;
18
24
  export declare const ROLE_STEP = "U\u017Cyj pe\u0142nej jednolitej mapy: `npx robisie init --agent codex --role ceo=codex --role builder=codex --role quality=codex` (role: ceo, builder, quality; dostawcy: claude, codex, opencode).";
package/dist/manifest.js CHANGED
@@ -5,6 +5,12 @@ import { PACKAGE_VERSION } from "./constants.js";
5
5
  import { RobisieError, errorMessage, shellQuote } from "./context.js";
6
6
  import { isAgentId } from "./agents.js";
7
7
  import { freeCopyPath } from "./fsops.js";
8
+ /** The login fields a rewrite of the manifest must carry forward. */
9
+ export function loginFields(manifest) {
10
+ return manifest?.credentialSource === "login"
11
+ ? { installation_id: manifest.installation_id, pair_id: manifest.pair_id, credentialSource: "login" }
12
+ : {};
13
+ }
8
14
  export const ROLE_IDS = ["ceo", "builder", "quality"];
9
15
  export const ROLE_STEP = "Użyj pełnej jednolitej mapy: `npx robisie init --agent codex --role ceo=codex --role builder=codex --role quality=codex` (role: ceo, builder, quality; dostawcy: claude, codex, opencode).";
10
16
  /** Legacy single-provider installs have one unambiguous assignment; explicit null stays null. */
@@ -173,6 +179,9 @@ export function readManifest(path) {
173
179
  throw new Error("brak pól");
174
180
  const manifest = { packageVersion: String(parsed.packageVersion ?? "?"), agents: parsed.agents, entries: parsed.entries };
175
181
  manifest.roleProviders = Object.hasOwn(parsed, "roleProviders") ? parsed.roleProviders : roleProviders(manifest);
182
+ if (parsed.credentialSource === "login" && typeof parsed.installation_id === "string" && typeof parsed.pair_id === "string") {
183
+ Object.assign(manifest, { installation_id: parsed.installation_id, pair_id: parsed.pair_id, credentialSource: "login" });
184
+ }
176
185
  return manifest;
177
186
  }
178
187
  catch {
@@ -13,7 +13,7 @@ export type PlanerClientConfig = ({
13
13
  };
14
14
  type Operation = "connect" | "close" | "list_projects" | "list_tracks" | "list_tasks" | "get_task" | "reserve_task" | "update_task" | "append_detail" | "close_decision_matter" | "get_review_snapshot" | "accept_review" | "create_track" | "create_task" | "move_task" | "write_decision_matter";
15
15
  type Failure = "INVALID_CONFIG" | "INVALID_ARGUMENT" | "NOT_CONNECTED" | "CLOSED" | "CONTRACT_VERSION" | "UNSUPPORTED_CONTRACT" | "INVALID_RESPONSE" | "DETAILS_READ_ERROR" | "TOOL_ERROR" | "UNAUTHORIZED" | "FORBIDDEN" | "RATE_LIMITED" | "HTTP_ERROR" | "RPC_ERROR" | "TRANSPORT_ERROR" | "TIMEOUT";
16
- /** Fixed reason only. In particular, never attach SDK message, cause, raw body or caller arguments. */
16
+ /** Only allowlisted diagnostics. Never attach SDK message, cause, raw body or caller arguments. */
17
17
  export declare class PlanerClientError extends Error {
18
18
  readonly code: Failure;
19
19
  readonly operation: Operation;
@@ -25,7 +25,9 @@ export declare class PlanerClientError extends Error {
25
25
  plannerCode?: string;
26
26
  requestId?: string;
27
27
  plannerMeta?: Record<string, unknown>;
28
+ gateReason?: string;
28
29
  });
30
+ readonly gateReason?: string;
29
31
  readonly plannerCode?: string;
30
32
  readonly requestId?: string;
31
33
  readonly plannerMeta?: Record<string, unknown>;
@@ -36,6 +38,10 @@ declare const projectSchema: z.ZodObject<{
36
38
  id: z.ZodUUID;
37
39
  name: z.ZodString;
38
40
  slug: z.ZodString;
41
+ reviewPolicy: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
42
+ legacy: "legacy";
43
+ enforced: "enforced";
44
+ }>>>;
39
45
  }, z.core.$strip>;
40
46
  declare const trackSchema: z.ZodObject<{
41
47
  id: z.ZodUUID;
@@ -4,7 +4,7 @@ import { CallToolResultSchema, ErrorCode, McpError } from "@modelcontextprotocol
4
4
  import { z } from "zod";
5
5
  import { CONTRACT_VERSION_HEADER, KEY_PATTERN, PACKAGE_NAME, PACKAGE_VERSION, mcpUrl } from "./constants.js";
6
6
  import { assertCompatible } from "./mcp.js";
7
- /** Fixed reason only. In particular, never attach SDK message, cause, raw body or caller arguments. */
7
+ /** Only allowlisted diagnostics. Never attach SDK message, cause, raw body or caller arguments. */
8
8
  export class PlanerClientError extends Error {
9
9
  code;
10
10
  operation;
@@ -17,6 +17,8 @@ export class PlanerClientError extends Error {
17
17
  this.operation = operation;
18
18
  this.uncertain = uncertain;
19
19
  this.name = "PlanerClientError";
20
+ if (diagnostic?.gateReason !== undefined)
21
+ this.gateReason = diagnostic.gateReason;
20
22
  if (diagnostic?.plannerCode !== undefined)
21
23
  this.plannerCode = diagnostic.plannerCode;
22
24
  if (diagnostic?.requestId !== undefined)
@@ -49,7 +51,7 @@ const boundedObject = jsonObject.refine(value => new TextEncoder().encode(JSON.s
49
51
  const freeText = z.string().max(2000);
50
52
  const name = z.string().min(1).max(500);
51
53
  const date = z.iso.datetime({ offset: true });
52
- const projectSchema = z.object({ id: uuid, name: z.string(), slug: z.string() });
54
+ const projectSchema = z.object({ id: uuid, name: z.string(), slug: z.string(), reviewPolicy: z.enum(["legacy", "enforced"]).nullable().optional() });
53
55
  const trackSchema = z.object({ id: uuid, projectId: uuid, name: z.string(), position: z.number().int() });
54
56
  const taskSchema = z.object({ id: uuid, projectId: uuid, trackId: uuid, title: z.string(), status,
55
57
  assignee: z.string().nullable(), dependsOn: z.array(uuid), specRef: z.string().nullable(), createdAt: date, updatedAt: date,
@@ -278,7 +280,11 @@ export class PlanerClient {
278
280
  value = JSON.parse(result.content[0].text);
279
281
  }
280
282
  catch {
281
- throw new PlanerClientError(result.isError ? "TOOL_ERROR" : "INVALID_RESPONSE", operation, mutation);
283
+ const text = result.content.length === 1 && result.content[0]?.type === "text" ? result.content[0].text : "";
284
+ // Plain-text gate refusal is the sole exception to untrusted network-text suppression.
285
+ const gateReason = result.isError && text.startsWith("Brama recenzji: ") && text.trim().length <= 200
286
+ && !/[\p{C}\p{Zl}\p{Zp}]/u.test(text) ? text.trim() : undefined;
287
+ throw new PlanerClientError(result.isError ? "TOOL_ERROR" : "INVALID_RESPONSE", operation, mutation, gateReason === undefined ? undefined : { gateReason });
282
288
  }
283
289
  return { value, isError: result.isError === true };
284
290
  }
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.2.2 \u2014 plik zarz\u0105dzany przez `npx robisie`; `npx robisie uninstall` go usunie -->";
20
+ export declare const MANAGED_LINE = "<!-- robisie:managed 0.4.0 \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;
package/docs/README.en.md CHANGED
@@ -1,4 +1,4 @@
1
- # robisie — from account to accepted card (package 0.2.2)
1
+ # robisie — from account to accepted card (package 0.4.0)
2
2
 
3
3
  In the project directory with its engine configuration, run `npx robisie init`, then `npx robisie doctor`: init prepares the project goal and tester protection list, and doctor checks both inputs.
4
4
 
@@ -57,6 +57,16 @@ Every doctor result includes `! Polityka enforced: NIE SPRAWDZONO — klient nie
57
57
 
58
58
  Polish CLI messages: `Brak klucza odbioru ROBISIE_REVIEW_KEY.` — Missing acceptance key ROBISIE_REVIEW_KEY.; `Klucz odbioru B jest tym samym tokenem co klucz A.` — Acceptance key B is the same token as key A.; `ROBISIE_REVIEW_KEY ma niepoprawny format.` — ROBISIE_REVIEW_KEY has an invalid format.; `Nie potwierdzono dostępu B do tablicy.` — Board access with key B could not be confirmed.; `Klucz B uwierzytelnia odczyt projektów.` — Key B authenticates project reads.
59
59
 
60
+ ### Sign in with a code: npx robisie login
61
+
62
+ Instead of copying keys from Connect you can pair the installation with one command in the installation directory: `npx robisie login`. It prints a code and a link to https://robisie.app/dashboard/connect/device. You or your agent, signed in to this account in the browser, compare the code with the terminal, confirm the sign-in again and approve both keys at once: A (worker) and B (owner_validator — full permissions, including deletion). The server always issues the A+B pair. The keys go straight into the installation's `key` and `review-key` files (0600, directory 0700): they never pass through the screen, the clipboard, chat or command history.
63
+
64
+ Exit code 0 means the pair is saved and confirmed. Exit code 2 means the pairing is waiting for approval — you are not signed in yet; resume it with the same `npx robisie login` before the code expires (10 minutes). Exit code 1 is an error with one next step. `npx robisie login --no-wait` only prints the code and link; `--timeout` sets how many seconds to wait (default 540). Without keys, without a terminal and without `--key-stdin`, init starts with this sign-in itself.
65
+
66
+ After sign-in, init, doctor and `npx robisie factory run` take A and B from the installation files. An old ROBISIE_KEY or ROBISIE_REVIEW_KEY value in the environment is then ignored with a warning that never prints the value — open a new terminal. Doctor does not require ROBISIE_REVIEW_KEY in the environment of such an installation. One robisie command runs at a time: a second one refuses with „Inna operacja robisie trwa” (another robisie operation is running). An interrupted pair write (for example a full disk) is finished by the next command; until then no command uses the keys in the files. Installations with keys pasted from Connect keep working as before.
67
+
68
+ The tester release is a single trust zone: on this computer the agent executing tasks technically also has access to the acceptance key (B). Run only agents you trust as yourself on it.
69
+
60
70
  <!-- sekcja: instalacja -->
61
71
  <a id="instalacja"></a>
62
72
  ## Install from npm
@@ -257,6 +267,13 @@ In other CEO sessions, including Codex, moving to delivered requires independent
257
267
 
258
268
  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.
259
269
 
270
+ ### Blocked card: retry or abandon
271
+
272
+ A card in the “Blocked” stage waits for the owner's decision. The scope protection is intentional: the worker key A cannot close the card — setting `done` with key A is refused with 403. `done` is reserved for accepting a result with evidence, not for releasing scope. Do not broaden key A or change roles to bypass the refusal.
273
+
274
+ - **Retry:** open the Planner in the Dashboard (`https://robisie.app/dashboard/plugins/planer`) (“Projects” section), choose a project and card, then select “Ready” (`ready`) under “Stage”. The card returns to the agent's queue.
275
+ - **Abandon:** in the same card window, click “Delete”; at “Are you sure you want to delete this?” choose “Yes, delete”. **Deletion is irreversible — it cannot be undone.** The `masz-<first 8 characters of the card id>` branch with the agent's work remains in the repository.
276
+
260
277
  <!-- sekcja: aktualizacja -->
261
278
  ## Update and private backup
262
279
 
@@ -446,12 +463,12 @@ Without an installation, begin with the account and Connect → init; repeating
446
463
  CLI messages remain in Polish. Match the message, then follow the English explanation:
447
464
 
448
465
  - **brak-klucza** — `Brak klucza robisie.`
449
- No key: generate one in Connect and supply it to init.
466
+ No key: generate one in Connect and supply it to init, or pair the installation: `npx robisie login`.
450
467
  - **odrzucony-klucz** — `Serwer robisie odrzucił klucz (nieważny albo unieważniony).`
451
468
  Generate a new worker key; in zsh/bash run `unset ROBISIE_KEY`, then init with the hidden prompt.
452
469
  - **brak-odczytu** — `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).`
453
470
  Select worker in Connect; `unset ROBISIE_KEY`, then init with the hidden prompt.
454
- - **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.2.2 (obsługuje 1.x).`
471
+ - **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.4.0 (obsługuje 1.x).`
455
472
  Example of a MAJOR mismatch: install a release compatible with the server contract.
456
473
  - **brak-env** — `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.`
457
474
  Check profile support; with --no-shell/another shell load the key file into the session environment as shown in init, then doctor.
package/docs/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # robisie — od konta do odebranej karty (paczka 0.2.2)
1
+ # robisie — od konta do odebranej karty (paczka 0.4.0)
2
2
 
3
3
  W katalogu projektu z konfiguracją silnika uruchom `npx robisie init`, potem `npx robisie doctor`: init przygotuje cel projektu i listę ochrony testera, a doctor sprawdzi oba wejścia.
4
4
 
@@ -57,6 +57,16 @@ A i B są zapisywane osobno w `${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key` i
57
57
 
58
58
  Każdy wynik doctor zawiera `! Polityka enforced: NIE SPRAWDZONO — klient nie ma API jej odczytu.` Odmowa kontekstu projektu następuje przed doctor i ma własną poradę. Zielony doctor nie oznacza aktywacji enforced. Przy błędzie B sprawdź dostęp do Connect i wystawienie owner_validator; awaria sieci nie dowodzi unieważnienia. Ponów init z poprawnym B w ENV, potem doctor. Zmiana polityki wymaga osobnej uprawnionej czynności operatora.
59
59
 
60
+ ### Logowanie kodem: npx robisie login
61
+
62
+ Zamiast przepisywać klucze z Connect możesz sparować instalację jednym poleceniem w katalogu instalacji: `npx robisie login`. Polecenie wypisuje kod i link do https://robisie.app/dashboard/connect/device. Ty albo Twój agent, zalogowany na to konto w przeglądarce, porównujecie kod z terminalem, ponownie potwierdzacie logowanie i zatwierdzacie oba klucze naraz: A (worker) i B (owner_validator — pełne uprawnienia, w tym usuwanie). Serwer zawsze wydaje parę A+B. Klucze trafiają prosto do plików `key` i `review-key` instalacji (0600, katalog 0700): nie przechodzą przez ekran, schowek, rozmowę ani historię poleceń.
63
+
64
+ Kod wyjścia 0 oznacza, że para jest zapisana i potwierdzona. Kod 2 oznacza, że parowanie czeka na zatwierdzenie — to jeszcze nie jest zalogowanie; wznów je tym samym `npx robisie login`, zanim kod wygaśnie (10 minut). Kod 1 to błąd z jednym następnym krokiem. `npx robisie login --no-wait` tylko wypisuje kod i link; `--timeout` ustala, ile sekund czekać (domyślnie 540). Bez kluczy, bez terminala i bez `--key-stdin` init sam zaczyna od tego logowania.
65
+
66
+ Po zalogowaniu init, doctor i `npx robisie factory run` biorą A i B z plików instalacji. Stara wartość ROBISIE_KEY lub ROBISIE_REVIEW_KEY w środowisku jest wtedy ignorowana z ostrzeżeniem, bez wypisywania jej treści — otwórz nowy terminal. Doctor nie wymaga ROBISIE_REVIEW_KEY w środowisku takiej instalacji. Naraz działa jedno polecenie robisie: drugie odmawia komunikatem „Inna operacja robisie trwa”. Przerwany zapis pary (np. brak miejsca na dysku) dokańcza następne polecenie; do tego czasu żadne polecenie nie używa kluczy z plików. Instalacje z kluczami wklejonymi z Connect działają jak dotąd.
67
+
68
+ Wersja dla testerów to jedna strefa zaufania: na tym komputerze agent wykonujący zadania technicznie ma dostęp także do klucza odbioru (B). Uruchamiaj na nim tylko agentów, którym ufasz jak sobie.
69
+
60
70
  <!-- sekcja: instalacja -->
61
71
  <a id="instalacja"></a>
62
72
  ## Instalacja z npm
@@ -65,6 +75,8 @@ Trzy role instalatora używają jednego dostawcy: CEO (`ceo`), Builder (`builder
65
75
 
66
76
  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.
67
77
 
78
+ Agent bez terminala interaktywnego korzysta z [instalacji przez agenta](#instalacja-agenta).
79
+
68
80
  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:
69
81
 
70
82
  ```sh
@@ -146,6 +158,47 @@ npx robisie doctor
146
158
 
147
159
  Dla Codex lub OpenCode zastąp `claude` przez `codex` lub `opencode`. Przy wcześniejszej konfiguracji użyj pełnej mapy z następnej sekcji; samo `--agent` jej nie kasuje. Oczekiwany wynik doctor: exit 0. Awaryjny zgodny tgz przygotuj według sekcji Aktualizacja. Pomocniki `client-launch-context` i `ceo-client-launcher` są konfigurowane przez init dla wersji paczki; lokalne wywołanie to `npx robisie mcp <nazwa>` z cwd instalacji. Wpisy agenta zachowują transport generowany przez paczkę; ta instrukcja go nie zmienia. npx może pobrać paczkę z sieci, gdy nie znajdzie wymaganej wersji lokalnie.
148
160
 
161
+ <!-- agent-install:start -->
162
+ <a id="instalacja-agenta"></a>
163
+ ### Instalacja przez agenta (bez terminala interaktywnego)
164
+
165
+ 1. Zacznij od uzgodnionej zgody na przebieg, konta, jednego projektu i wymagań opisanych powyżej. W przygotowanym pustym katalogu utwórz manifest i zainstaluj paczkę:
166
+
167
+ ```sh
168
+ cd "/ścieżka/do/pustego katalogu" &&
169
+ node -e 'try {
170
+ require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
171
+ } catch (error) {
172
+ 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.");
173
+ process.exit(1);
174
+ }' &&
175
+ npm i robisie
176
+ ```
177
+
178
+ 2. Wybierz sposób przekazania kluczy przed init. Przy bezpiecznie przygotowanych ENV ustaw A jako `ROBISIE_KEY` (worker), a osobny B jako `ROBISIE_REVIEW_KEY` (owner_validator); zachowaj je w środowisku init, doctor i sesji agentów. Nie usuwaj tych zmiennych przed init i nie wykonuj bloku nowej instalacji dla człowieka, który je usuwa. Nie wypisuj kluczy ani nie wklejaj ich do rozmowy, karty, argumentów lub historii poleceń. Wyłącz śledzenie powłoki przed przekazaniem sekretów i wyeksportuj przygotowane zmienne:
179
+
180
+ ```sh
181
+ set +x
182
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
183
+ ```
184
+
185
+ Zamiast linii init w kroku 3 możesz użyć `--key-stdin`, które pobiera tylko A z wejścia standardowego: istniejący przykład to `printenv MY_KEY | npx robisie init --key-stdin`. B nadal przekaż przez `ROBISIE_REVIEW_KEY`; zachowaj pełne przypisanie dostawcy z kroku 3. Przy `--no-shell` również zachowaj oba ENV.
186
+
187
+ Jeśli nie masz bezpiecznie przygotowanych kluczy, uruchom w katalogu instalacji `npx robisie login`. Polecenie wypisze kod i link do https://robisie.app/dashboard/connect/device. Człowiek zalogowany na własne konto w przeglądarce porównuje kod, ponownie potwierdza logowanie i zatwierdza parę A+B. Dopiero exit 0 potwierdza zapis kluczy w plikach instalacji; exit 2 oznacza oczekiwanie — wznów to samo polecenie przed wygaśnięciem kodu (10 minut). Po tym logowaniu init i doctor używają plików instalacji.
188
+
189
+ 3. W tym samym katalogu wykonaj init i dopiero po jego sukcesie zwykły doctor. Wybierz jednego zainstalowanego dostawcę dla wszystkich trzech ról; dla Codex/OpenCode zastąp każde `claude` przez `codex`/`opencode`:
190
+
191
+ ```sh
192
+ npx robisie init --agent claude --role ceo=claude --role builder=claude --role quality=claude &&
193
+ npx robisie doctor
194
+ ```
195
+
196
+ Łańcuch `&&` zatrzymuje wykonanie po błędzie. Przy odmowie napraw wskazaną przyczynę przed ponowieniem; nie zastępuj zwykłego doctor walidacją `--engine-config`, która nie sprawdza kluczy.
197
+
198
+ 4. Dopiero po doctor z exit 0 przejdź do sekcji „Pierwsza karta i start Buildera”, zgodnie z uzgodnionym celem i zakresem zapisu.
199
+
200
+ <!-- agent-install:end -->
201
+
149
202
  <!-- sekcja: init -->
150
203
  ## Połączenie agenta
151
204
 
@@ -220,6 +273,8 @@ npx robisie doctor
220
273
 
221
274
  Doctor sprawdza kontrakt, odczyt projektów, konfigurację, role, start pomocników, `ROBISIE_KEY` oraz wolne miejsce na dysku instalacji. Przy dysku wypisuje HOLD poniżej 15 GiB i histerezę odblokowania od 18 GiB; poniżej 15 GiB kończy się exit 1. Pokazuje mapę: null lub mieszana mapa daje exit 1; wróć do pełnego przypisania jednego dostawcy w sekcji init. „Powyższe kontrole przeszły” oznacza powodzenie tych kontroli, nie pełnej pętli pracy. Linia „Gotowość wykonawców Codex–Grok” mówi osobno, czy sprawdzono logowanie Codex (`codex login status`) i Groka (`grok models`, więc tylko „prawdopodobnie zalogowany”).
222
275
 
276
+ Gdy klucz A widzi dokładnie jeden projekt, doctor odczytuje jego `reviewPolicy` przez `list_projects`. Dla `enforced` pokazuje „✓ Polityka enforced: TAK”. Dla `legacy` ostrzega, że odbiór B (`accept_review`) będzie odmawiany, i kieruje do operatora Robisie po ustawienie `enforced`. Starszy serwer bez pola, `null` lub błąd odczytu daje „NIE SPRAWDZONO” z powodem. Ta linia jest informacyjna i nie zmienia kodu wyjścia doctora. Klient tylko odczytuje politykę; ustawia ją wyłącznie operator.
277
+
223
278
  Doctor uruchamia plik pomocnika przez node, agent przez npx. `ROBISIE_PROJECT_CONTEXT` wybiera kontekst później i nie zmienia cwd szukania paczki. Uruchom agenta w katalogu instalacji i poproś o wyświetlenie dostępnych narzędzi OBU serwerów: `client-launch-context` (`get_launch_context`, `get_project_context`, `run_project_check`, `prepare_review`, `create_review_receipt`, `verify_stored_review`) oraz `ceo-client-launcher` (`spawn_builder`, `verify_review_receipt`). Wynik: oba serwery dostępne z kompletem tych narzędzi w sesji. Nie uruchamiaj spawn_builder tylko dla próby. Przy braku pomocnika wróć do cwd instalacji, sprawdź lokalną wersję i konfigurację, uruchom init/doctor, potem nową sesję agenta. Sam doctor nie potwierdza dostępności narzędzi u dostawcy.
224
279
 
225
280
  <!-- sekcja: pierwsza-karta -->
@@ -257,6 +312,13 @@ W innych sesjach CEO, w tym Codex, przejście do delivered wymaga niezależnej r
257
312
 
258
313
  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.
259
314
 
315
+ ### Karta zablokowana: ponów albo porzuć
316
+
317
+ Karta w etapie „Zablokowane” czeka na decyzję właściciela. Ochrona zakresu jest celowa: klucz roboczy A (worker) nie zamknie karty — próba ustawienia `done` kluczem A kończy się odmową 403. `done` jest zarezerwowane dla odbioru wyniku z dowodem, nie do zwalniania zakresu. Nie rozszerzaj klucza A ani nie zmieniaj ról, żeby obejść odmowę.
318
+
319
+ - **Ponów:** otwórz Planer w panelu Dashboard (`https://robisie.app/dashboard/plugins/planer`) (sekcja „Projekty”), wybierz projekt i kartę. W sekcji „Etap” wybierz „Do wzięcia” (`ready`), a karta wróci do kolejki agenta.
320
+ - **Porzuć:** w tym samym oknie karty kliknij „Usuń”; na pytanie „Na pewno usunąć?” wybierz „Tak, usuń”. **Usunięcie jest nieodwracalne — nie da się go cofnąć.** Gałąź `masz-<pierwsze 8 znaków id karty>` z pracą agenta zostaje w repozytorium.
321
+
260
322
  <!-- sekcja: aktualizacja -->
261
323
  ## Aktualizacja i prywatna kopia
262
324
 
@@ -446,12 +508,12 @@ Bez instalacji zacznij od konta i Connect → init; samo ponawianie doctor nie z
446
508
  Komunikaty CLI pozostają po polsku. Dopasuj komunikat, a potem wykonaj wskazaną czynność:
447
509
 
448
510
  - **brak-klucza** — `Brak klucza robisie.`
449
- Wygeneruj klucz w Connect i przekaż go do init.
511
+ Wygeneruj klucz w Connect i przekaż go do init albo sparuj instalację: `npx robisie login`.
450
512
  - **odrzucony-klucz** — `Serwer robisie odrzucił klucz (nieważny albo unieważniony).`
451
513
  Wygeneruj nowy klucz worker; w zsh/bash wykonaj `unset ROBISIE_KEY`, potem init z ukrytym pytaniem.
452
514
  - **brak-odczytu** — `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).`
453
515
  Wybierz worker w Connect; `unset ROBISIE_KEY`, potem init z ukrytym pytaniem.
454
- - **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.2.2 (obsługuje 1.x).`
516
+ - **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.4.0 (obsługuje 1.x).`
455
517
  Przykład niezgodnego MAJOR: zainstaluj wydanie zgodne z kontraktem serwera.
456
518
  - **brak-env** — `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.`
457
519
  Sprawdź obsługę profilu; przy --no-shell/innej powłoce wczytaj plik klucza do środowiska sesji jak w init, potem doctor.
@@ -81,6 +81,7 @@ export const config = parseConfig({
81
81
  - `dist/context.js`
82
82
  - `dist/delivery-local.js`
83
83
  - `dist/dependency-readiness.js`
84
+ - `dist/device-login.js`
84
85
  - `dist/disk-guard.js`
85
86
  - `dist/dispatch-scope.js`
86
87
  - `dist/done-evidence.js`
@@ -97,6 +98,7 @@ export const config = parseConfig({
97
98
  - `dist/k3-codex-role.js`
98
99
  - `dist/k3-helper-cli.js`
99
100
  - `dist/local-usage.js`
101
+ - `dist/login.js`
100
102
  - `dist/manifest.js`
101
103
  - `dist/mcp.js`
102
104
  - `dist/opencode-result.js`
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "robisie",
3
- "version": "0.2.2",
3
+ "version": "0.4.0",
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",