robisie 0.1.3 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +73 -19
  3. package/dist/agents.d.ts +1 -1
  4. package/dist/agents.js +1 -1
  5. package/dist/ci-failure-result.js +1 -1
  6. package/dist/cli.d.ts +2 -0
  7. package/dist/cli.js +45 -8
  8. package/dist/codex-env.d.ts +9 -0
  9. package/dist/codex-env.js +60 -0
  10. package/dist/commands.js +140 -16
  11. package/dist/constants.d.ts +1 -1
  12. package/dist/constants.js +1 -1
  13. package/dist/delivery-local.d.ts +124 -0
  14. package/dist/delivery-local.js +286 -0
  15. package/dist/done-evidence.d.ts +25 -1
  16. package/dist/done-evidence.js +59 -1
  17. package/dist/engine/bundle-report.json +1687 -0
  18. package/dist/engine/tick.cjs +324704 -0
  19. package/dist/engine-config.d.ts +3 -1
  20. package/dist/engine-config.js +3 -3
  21. package/dist/factory-run.d.ts +17 -0
  22. package/dist/factory-run.js +262 -0
  23. package/dist/helpers.js +1 -1
  24. package/dist/k3-codex-job.d.ts +49 -0
  25. package/dist/k3-codex-job.js +324 -0
  26. package/dist/k3-helper-cli.d.ts +5 -0
  27. package/dist/k3-helper-cli.js +167 -0
  28. package/dist/local-usage.d.ts +47 -0
  29. package/dist/local-usage.js +230 -0
  30. package/dist/manifest.d.ts +5 -2
  31. package/dist/manifest.js +6 -6
  32. package/dist/opencode-review-guard.js +7 -2
  33. package/dist/planer-client.d.ts +45 -4
  34. package/dist/planer-client.js +120 -14
  35. package/dist/roles.d.ts +1 -1
  36. package/dist/seed-package.d.ts +10 -0
  37. package/dist/seed-package.js +62 -0
  38. package/dist/select-fingerprint.d.ts +19 -0
  39. package/dist/select-fingerprint.js +46 -0
  40. package/dist/task-mktemp.d.ts +1 -0
  41. package/dist/task-mktemp.js +40 -0
  42. package/dist/test-report.d.ts +9 -0
  43. package/dist/test-report.js +139 -0
  44. package/dist/tester-result-reader.d.ts +87 -0
  45. package/dist/tester-result-reader.js +122 -0
  46. package/docs/ENGINE-API.md +9 -1
  47. package/docs/README.en.md +161 -66
  48. package/docs/README.md +159 -66
  49. package/docs/RELEASE-0.1.0.md +29 -5
  50. package/helpers/ceo-client-launcher-mcp.mjs +76 -5
  51. package/package.json +6 -2
  52. package/roles/ceo-client.md +10 -8
package/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.2.0)
2
2
 
3
3
  Polski: [README.md](README.md).
4
4
 
@@ -9,13 +9,13 @@ 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>
16
16
  ## Requirements
17
17
 
18
- The human prepares Node.js 20+, npm, internet for dependencies and robisie, and one provider program: Claude Code, Codex CLI or OpenCode with their own AI access. Check `node --version`, `npm --version` and the chosen program's version (`claude --version`, `codex --version` or `opencode --version`). If absent from PATH, install it following its provider's instructions and check again; a configuration directory alone is insufficient. Windows/WSL are unverified; examples below use POSIX paths.
18
+ The human prepares Node.js 24+ (release used for checks: 24.3.0), npm, internet for dependencies and robisie, and one provider program: Claude Code, Codex CLI or OpenCode with their own AI access. An older Node, such as 22, is refused before `init`, `doctor` and `factory run`. The engine bundled in the package (`dist/engine/tick.cjs`) requires Linux and is started by `npx robisie factory run`; the engine configuration is described in [ENGINE-CONFIG](ENGINE-CONFIG.md). Check `node --version`, `npm --version` and the chosen program's version (`claude --version`, `codex --version` or `opencode --version`). If absent from PATH, install it following its provider's instructions and check again; a configuration directory alone is insufficient. Windows/WSL are unverified; examples below use POSIX paths.
19
19
 
20
20
  Prepare an empty directory on disk. You do not need a website or your own `package.json`; the Node.js step below creates it before installation. This is the agents' working directory, separate from the dashboard project.
21
21
 
@@ -25,48 +25,71 @@ 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
 
38
44
  `worker` is the minimal path: read, create/update projects, tracks and cards, reserve work; no setting `done` through create/update. `observer` only reads. Explicitly choose `worker` each time: later keys default to `observer` (the first-key screen may preselect worker); do not infer permissions from that default. `full` adds deletion and closing decision matters; `owner_validator` has the same access level as full. `seeder` has narrow access to `get_task` and valid seeding through `append_detail`, without `list_projects`/board reads, so it cannot follow this guide.
39
45
 
40
- The package stores **one key for CEO, Builder and Quality Officer** as `ROBISIE_KEY`. Role names do not change permissions. Do not use full to bypass acceptance of `done`: the owner accepts in the dashboard without broadening the agent's key.
46
+ The package stores **one worker key for CEO, Builder and Quality Officer** as `ROBISIE_KEY`. Role names do not change permissions. Do not use full to bypass acceptance of `done`: the owner accepts in the dashboard without broadening the agent's key.
47
+
48
+ Two distinct keys are required: A (`ROBISIE_KEY`, worker) and B (`ROBISIE_REVIEW_KEY`, owner_validator). At https://robisie.app/dashboard/connect generate a NEW B key, select `owner_validator` and use a label different from A: reusing A's label rotates A. A label does not restrict a key to one project. Supply B outside chat through init's separate hidden prompt or securely prepared ENV; `--key-stdin` reads only A. B ENV takes priority over the saved `review-key` and the prompt; surrounding spaces are invalid. Reinstall reuses saved B when ENV is empty. A nonempty invalid B must be repaired, without falling back to another source.
49
+
50
+ A and B are stored separately in `${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key` and `review-key` (0600 files, 0700 directory). B never enters agent/model configuration, the manifest, arguments, claims or output. Load both environment variables, including with `--no-shell`. Run ordinary `npx robisie doctor` before the first task: `--engine-config` does not check keys. If A is missing or malformed, doctor diagnoses A; B checks begin only when A is present and has a valid format. Missing B, B=A, invalid format or failed B reads produce exit 1. B uses only `initialize` + `list_projects`, with no business-data mutations; auth counters may increase. Successful reads do not confirm role, a shared A/B account or project policy.
51
+
52
+ Every doctor result includes `! Polityka enforced: NIE SPRAWDZONO — klient nie ma API jej odczytu.`: enforced policy: NOT CHECKED — the client has no API to read it. Project-context refusal happens before doctor and has its own advice. Green doctor does not activate enforced. For a B failure check Connect access and issuance as owner_validator; a network failure does not prove revocation. Retry init with correct B ENV, then doctor. Policy changes require a separate authorized operator action.
53
+
54
+ 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.
41
55
 
42
56
  <!-- sekcja: instalacja -->
43
57
  <a id="instalacja"></a>
44
58
  ## Install from npm
45
59
 
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:
60
+ 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.
61
+
62
+ 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.
63
+
64
+ 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
65
 
48
66
  ```sh
49
67
  cd "/path/to/empty directory" &&
50
68
  node -e 'try {
51
69
  require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
52
70
  } catch (error) {
53
- console.error(error.message);
71
+ 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
72
  process.exit(1);
55
73
  }' &&
56
74
  {
57
75
  set +x
58
76
  npm i robisie &&
59
- unset ROBISIE_KEY &&
77
+ unset ROBISIE_KEY ROBISIE_REVIEW_KEY &&
60
78
  npx robisie init --agent claude &&
61
79
  {
62
80
  if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
63
81
  [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
64
82
  [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
83
+ [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
84
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
85
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
86
+ ROBISIE_REVIEW_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" 2>/dev/null)" &&
87
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
65
88
  ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
66
89
  [ -n "$ROBISIE_KEY" ]; then
67
- export ROBISIE_KEY
90
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
68
91
  else
69
- printf '%s\n' 'Cannot load a nonempty regular readable robisie key file.' 'Next step: check the key file and its permissions locally; resolve links/directories without overwriting data. If the key is missing or revoked, use Connect and init with the hidden prompt. Never paste the key into chat.' >&2
92
+ printf '%s\n' 'Cannot load both nonempty regular readable robisie key files (key, review-key).' 'Next step: check the key file and its permissions locally; resolve links/directories without overwriting data. If B is missing or rejected, supply a fresh owner_validator key via ROBISIE_REVIEW_KEY to init; --key-stdin replaces only A. Never paste the key into chat.' >&2
70
93
  false
71
94
  fi
72
95
  } &&
@@ -76,7 +99,7 @@ npx robisie doctor
76
99
 
77
100
  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
101
 
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.
102
+ 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
103
 
81
104
  <!-- reinstall:start -->
82
105
  ```sh
@@ -85,11 +108,16 @@ set +x
85
108
  if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
86
109
  [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
87
110
  [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
111
+ [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
112
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
113
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
114
+ ROBISIE_REVIEW_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" 2>/dev/null)" &&
115
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
88
116
  ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
89
117
  [ -n "$ROBISIE_KEY" ]; then
90
- export ROBISIE_KEY
118
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
91
119
  else
92
- printf '%s\n' 'Cannot load a nonempty regular readable robisie key file.' 'Next step: check the key file and its permissions locally; resolve links/directories without overwriting data. If the key is missing or revoked, use Connect and init with the hidden prompt. Never paste the key into chat.' >&2
120
+ printf '%s\n' 'Cannot load both nonempty regular readable robisie key files (key, review-key).' 'Next step: check the key file and its permissions locally; resolve links/directories without overwriting data. If B is missing or rejected, supply a fresh owner_validator key via ROBISIE_REVIEW_KEY to init; --key-stdin replaces only A. Never paste the key into chat.' >&2
93
121
  false
94
122
  fi
95
123
  } &&
@@ -143,11 +171,16 @@ set +x
143
171
  if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
144
172
  [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
145
173
  [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
174
+ [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
175
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
176
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
177
+ ROBISIE_REVIEW_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" 2>/dev/null)" &&
178
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
146
179
  ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
147
180
  [ -n "$ROBISIE_KEY" ]; then
148
- export ROBISIE_KEY
181
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
149
182
  else
150
- printf '%s\n' 'Cannot load a nonempty regular readable robisie key file.' 'Next step: check the key file and its permissions locally; resolve links/directories without overwriting data. If the key is missing or revoked, use Connect and init with the hidden prompt. Never paste the key into chat.' >&2
183
+ printf '%s\n' 'Cannot load both nonempty regular readable robisie key files (key, review-key).' 'Next step: check the key file and its permissions locally; resolve links/directories without overwriting data. If B is missing or rejected, supply a fresh owner_validator key via ROBISIE_REVIEW_KEY to init; --key-stdin replaces only A. Never paste the key into chat.' >&2
151
184
  false
152
185
  fi
153
186
  }
@@ -188,9 +221,9 @@ Doctor runs the helper file via node, the agent via npx. `ROBISIE_PROJECT_CONTEX
188
221
  <!-- sekcja: pierwsza-karta -->
189
222
  ## First card and Builder startup
190
223
 
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:
224
+ 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
225
 
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.
226
+ > 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
227
 
195
228
  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
229
 
@@ -216,13 +249,25 @@ In Claude Code, the CEO starts an independent Quality Officer through `Agent(qua
216
249
 
217
250
  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
251
 
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.
252
+ 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
253
 
221
254
  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
255
 
223
256
  <!-- sekcja: aktualizacja -->
224
257
  ## Update and private backup
225
258
 
259
+ ### Update before the first init
260
+
261
+ 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.
262
+
263
+ <!-- before-init-update:start -->
264
+ ```sh
265
+ npm i robisie@latest
266
+ ```
267
+ <!-- before-init-update:end -->
268
+
269
+ ### Update after init
270
+
226
271
  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
272
 
228
273
  ```sh
@@ -242,41 +287,70 @@ Keep the installation's HOME, XDG_CONFIG_HOME and CODEX_HOME values (the command
242
287
 
243
288
  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
289
 
245
- Follow four steps; the table is a reference for selecting files, not twenty mandatory copies:
290
+ Follow four steps; the command pairs below are a reference for selecting files, not twenty mandatory copies:
246
291
 
247
292
  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
293
  2. From `manifest.entries`, select only installed providers, the recorded profile, roles and prior backups. Apply all path, type and readability checks below.
249
294
  3. Make and check only those copies; retain their paths and the selected release tgz privately.
250
295
  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
296
 
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"` |
278
-
279
- 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:
297
+ 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.
298
+
299
+ 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.
300
+
301
+ Copy: select only the required commands, checking each result.
302
+
303
+ ```sh
304
+ cp -p -- "$PWD/package.json" "$backup/project/package.json"
305
+ cp -p -- "$PWD/package-lock.json" "$backup/project/package-lock.json"
306
+ cp -p -- "$PWD/robisie.config.json" "$backup/project/robisie.config.json"
307
+ cp -p -- "$config_home/robisie/key" "$backup/robisie/key"
308
+ cp -p -- "$config_home/robisie/review-key" "$backup/robisie/review-key"
309
+ cp -p -- "$config_home/robisie/manifest.json" "$backup/robisie/manifest.json"
310
+ cp -Rp -- "$config_home/robisie/backups/." "$backup/robisie/backups/"
311
+ cp -Rp -- "$config_home/robisie/roles/codex/." "$backup/robisie/roles/codex/"
312
+ cp -p -- "$HOME/.claude.json" "$backup/claude/claude.json"
313
+ cp -p -- "$HOME/.claude/agents/ceo-client.md" "$backup/claude/agents/ceo-client.md"
314
+ cp -p -- "$HOME/.claude/agents/manager-builder-client.md" "$backup/claude/agents/manager-builder-client.md"
315
+ cp -p -- "$HOME/.claude/agents/quality-officer-client.md" "$backup/claude/agents/quality-officer-client.md"
316
+ cp -p -- "$codex_home/config.toml" "$backup/codex/config.toml"
317
+ cp -p -- "$codex_home/AGENTS.md" "$backup/codex/AGENTS.md"
318
+ cp -p -- "$config_home/opencode/opencode.json" "$backup/opencode/opencode.json"
319
+ cp -p -- "$config_home/opencode/agents/ceo-client.md" "$backup/opencode/agents/ceo-client.md"
320
+ cp -p -- "$config_home/opencode/agents/manager-builder-client.md" "$backup/opencode/agents/manager-builder-client.md"
321
+ cp -p -- "$config_home/opencode/agents/quality-officer-client.md" "$backup/opencode/agents/quality-officer-client.md"
322
+ cp -p -- "$config_home/opencode/plugins/robisie-review-guard.js" "$backup/opencode/plugins/robisie-review-guard.js"
323
+ cp -p -- "$profile" "$backup/profile/selected"
324
+ cp -p -- "$entry_path" "$backup/entries/$entry_id"
325
+ ```
326
+
327
+ Restore: the same source/copy pairs in the same order, only after comparison.
328
+
329
+ ```sh
330
+ cp -p -- "$backup/project/package.json" "$PWD/package.json"
331
+ cp -p -- "$backup/project/package-lock.json" "$PWD/package-lock.json"
332
+ cp -p -- "$backup/project/robisie.config.json" "$PWD/robisie.config.json"
333
+ cp -p -- "$backup/robisie/key" "$config_home/robisie/key"
334
+ cp -p -- "$backup/robisie/review-key" "$config_home/robisie/review-key"
335
+ cp -p -- "$backup/robisie/manifest.json" "$config_home/robisie/manifest.json"
336
+ cp -Rp -- "$backup/robisie/backups/." "$config_home/robisie/backups/"
337
+ cp -Rp -- "$backup/robisie/roles/codex/." "$config_home/robisie/roles/codex/"
338
+ cp -p -- "$backup/claude/claude.json" "$HOME/.claude.json"
339
+ cp -p -- "$backup/claude/agents/ceo-client.md" "$HOME/.claude/agents/ceo-client.md"
340
+ cp -p -- "$backup/claude/agents/manager-builder-client.md" "$HOME/.claude/agents/manager-builder-client.md"
341
+ cp -p -- "$backup/claude/agents/quality-officer-client.md" "$HOME/.claude/agents/quality-officer-client.md"
342
+ cp -p -- "$backup/codex/config.toml" "$codex_home/config.toml"
343
+ cp -p -- "$backup/codex/AGENTS.md" "$codex_home/AGENTS.md"
344
+ cp -p -- "$backup/opencode/opencode.json" "$config_home/opencode/opencode.json"
345
+ cp -p -- "$backup/opencode/agents/ceo-client.md" "$config_home/opencode/agents/ceo-client.md"
346
+ cp -p -- "$backup/opencode/agents/manager-builder-client.md" "$config_home/opencode/agents/manager-builder-client.md"
347
+ cp -p -- "$backup/opencode/agents/quality-officer-client.md" "$config_home/opencode/agents/quality-officer-client.md"
348
+ cp -p -- "$backup/opencode/plugins/robisie-review-guard.js" "$config_home/opencode/plugins/robisie-review-guard.js"
349
+ cp -p -- "$backup/profile/selected" "$profile"
350
+ cp -p -- "$backup/entries/$entry_id" "$entry_path"
351
+ ```
352
+
353
+ Once the tgz and selected copies are ready, update. Init reuses saved A and B for an existing installation; ENV takes priority. Explicit `--key-stdin` replaces only A. Doctor and the launcher still require both environment variables. 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
354
 
281
355
  <!-- update:start -->
282
356
  ```sh
@@ -287,11 +361,16 @@ export XDG_CONFIG_HOME &&
287
361
  if [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
288
362
  [ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
289
363
  [ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
364
+ [ ! -L "$XDG_CONFIG_HOME/robisie/review-key" ] &&
365
+ [ -f "$XDG_CONFIG_HOME/robisie/review-key" ] &&
366
+ [ -r "$XDG_CONFIG_HOME/robisie/review-key" ] &&
367
+ ROBISIE_REVIEW_KEY="$(cat "$XDG_CONFIG_HOME/robisie/review-key" 2>/dev/null)" &&
368
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
290
369
  ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key" 2>/dev/null)" &&
291
370
  [ -n "$ROBISIE_KEY" ]; then
292
- export ROBISIE_KEY
371
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
293
372
  else
294
- printf '%s\n' 'Cannot load a nonempty regular readable robisie key file.' 'Next step: check the key file and its permissions locally; resolve links/directories without overwriting data. If the key is missing or revoked, use Connect and init with the hidden prompt. Never paste the key into chat.' >&2
373
+ printf '%s\n' 'Cannot load both nonempty regular readable robisie key files (key, review-key).' 'Next step: check the key file and its permissions locally; resolve links/directories without overwriting data. If B is missing or rejected, supply a fresh owner_validator key via ROBISIE_REVIEW_KEY to init; --key-stdin replaces only A. Never paste the key into chat.' >&2
295
374
  false
296
375
  fi
297
376
  } &&
@@ -305,9 +384,9 @@ Doctor checks the contract MAJOR; exit 0 also requires its other checks. Choose
305
384
 
306
385
  ### Return to the previous release
307
386
 
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.
387
+ 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
388
 
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:
389
+ 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
390
 
312
391
  <!-- restore:start -->
313
392
  ```sh
@@ -318,11 +397,16 @@ export XDG_CONFIG_HOME &&
318
397
  if [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
319
398
  [ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
320
399
  [ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
400
+ [ ! -L "$XDG_CONFIG_HOME/robisie/review-key" ] &&
401
+ [ -f "$XDG_CONFIG_HOME/robisie/review-key" ] &&
402
+ [ -r "$XDG_CONFIG_HOME/robisie/review-key" ] &&
403
+ ROBISIE_REVIEW_KEY="$(cat "$XDG_CONFIG_HOME/robisie/review-key" 2>/dev/null)" &&
404
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
321
405
  ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key" 2>/dev/null)" &&
322
406
  [ -n "$ROBISIE_KEY" ]; then
323
- export ROBISIE_KEY
407
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
324
408
  else
325
- printf '%s\n' 'Cannot load a nonempty regular readable robisie key file.' 'Next step: check the key file and its permissions locally; resolve links/directories without overwriting data. If the key is missing or revoked, use Connect and init with the hidden prompt. Never paste the key into chat.' >&2
409
+ printf '%s\n' 'Cannot load both nonempty regular readable robisie key files (key, review-key).' 'Next step: check the key file and its permissions locally; resolve links/directories without overwriting data. If B is missing or rejected, supply a fresh owner_validator key via ROBISIE_REVIEW_KEY to init; --key-stdin replaces only A. Never paste the key into chat.' >&2
326
410
  false
327
411
  fi
328
412
  } &&
@@ -334,7 +418,7 @@ npx robisie doctor
334
418
 
335
419
  The `--no-save` option preserves the restored `package.json` and `package-lock.json` without recording a `file:` dependency on the private backup path.
336
420
 
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.
421
+ 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
422
 
339
423
  <!-- sekcja: odinstalowanie -->
340
424
  ## Uninstall
@@ -346,6 +430,8 @@ npm uninstall robisie
346
430
 
347
431
  The first command removes robisie entries and blocks from files recorded in the installation manifest and undoes role installation. It does not restore old robisie entries. User-edited roles remain with a warning; backups remain and may contain an old key. Without an installation record the command changes nothing and **does not delete the key file**. A refusal during the Codex configuration check occurs **before key deletion**; after that check the key file is removed even if a later undo fails. A nonzero exit requires preserving your edits and resolving the reported problem before retrying. Open a new terminal. Uninstall does not revoke the key on the server: revoke it separately in Connect. The second command removes the package from the project and may change `package.json`, `package-lock.json` and `node_modules`; the npm cache may remain. Do not mass-delete those files or the cache. A later npx call may download the package again.
348
432
 
433
+ Backup and restore must include both key and review-key, with the same private permissions; load both restored keys before init/doctor. Uninstall reports each local key file separately and removes both under the same ledger/configuration safeguards. It does not revoke either server key.
434
+
349
435
  Retained backups, including private update copies, may still contain the key after uninstall. Keep them private according to your retention needs; uninstall does not erase or revoke those copies. This guide does not delete them automatically.
350
436
 
351
437
  <!-- sekcja: diagnoza -->
@@ -355,17 +441,24 @@ Without an installation, begin with the account and Connect → init; repeating
355
441
 
356
442
  CLI messages remain in Polish. Match the message, then follow the English explanation:
357
443
 
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. |
444
+ - **brak-klucza** — `Brak klucza robisie.`
445
+ No key: generate one in Connect and supply it to init.
446
+ - **odrzucony-klucz** — `Serwer robisie odrzucił klucz (nieważny albo unieważniony).`
447
+ Generate a new worker key; in zsh/bash run `unset ROBISIE_KEY`, then init with the hidden prompt.
448
+ - **brak-odczytu** — `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).`
449
+ Select worker in Connect; `unset ROBISIE_KEY`, then init with the hidden prompt.
450
+ - **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.2.0 (obsługuje 1.x).`
451
+ Example of a MAJOR mismatch: install a release compatible with the server contract.
452
+ - **brak-env** — `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.`
453
+ Check profile support; with --no-shell/another shell load the key file into the session environment as shown in init, then doctor.
454
+ - **brak-programu** — `katalog jest, programu nie ma w PATH`
455
+ Install the named provider program or add it to PATH; a configuration directory alone is insufficient.
456
+ - **brak-programu-i-katalogu** — `brak programu w PATH i katalogu dostawcy`
457
+ Install the selected program, repeat init with the complete shared map and doctor.
458
+ - **jsonc** — `nie zmieniam automatycznie`
459
+ Preserve JSONC; prepare supported JSON or choose another provider for all roles. Remote MCP alone is insufficient.
460
+ - **niepelna-instalacja** — `Claude Code: niepełna instalacja`
461
+ Example of missing configuration: repeat init for your agent.
369
462
 
370
463
  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
464
 
@@ -375,3 +468,5 @@ After repair with an existing record, load the saved key as shown in Update befo
375
468
  The installer does not start background services or the Builder on its own; after operator approval, the CEO can start the Builder through `spawn_builder`. Helpers run during agent sessions using the project directory (or `ROBISIE_PROJECT_CONTEXT`) as context. The installer contacts robisie to check the contract and key; the package file does not provide an account or AI provider access. One shared key identity does not provide three different permission levels. Acceptance requires independent review, evidence and the operator's approval.
376
469
 
377
470
  Windows/WSL are unverified. Offline validation checks configuration structure, not project UUID, repo existence, model availability or provider execution.
471
+
472
+ The package engine (`dist/engine/tick.cjs`) is separate from the installer: it is started by `npx robisie factory run --engine-config ./robisie.config.json` and only on Linux; on any other system the command refuses with code 2 and a message. The `--once` option runs one tick without a pause and excludes an explicit `--interval`. Every nonzero tick result stops the supervisor („Fabryka zatrzymana: …”) with one diagnostic line on stderr; code 2 means an escalation (e.g. missing B key after receiver PASS, tester refusal, acceptance STOP) that must be resolved before retrying, and code 78 points to configuration repair. Real customer use on Linux will be proven in the D9 acceptance; on other systems there is no native proof of the engine running. Automatic FJ plans for customers are announced (“soon”) but are not in this release; the selector returns the true result.