robisie 0.1.4 → 0.2.1

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 (50) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/README.md +39 -11
  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 +145 -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/disk-guard.d.ts +20 -0
  16. package/dist/disk-guard.js +63 -0
  17. package/dist/done-evidence.d.ts +25 -1
  18. package/dist/done-evidence.js +59 -1
  19. package/dist/engine/bundle-report.json +1687 -0
  20. package/dist/engine/tick.cjs +324787 -0
  21. package/dist/engine-config.d.ts +3 -1
  22. package/dist/engine-config.js +3 -3
  23. package/dist/factory-run.d.ts +17 -0
  24. package/dist/factory-run.js +262 -0
  25. package/dist/helpers.js +1 -1
  26. package/dist/k3-codex-job.d.ts +49 -0
  27. package/dist/k3-codex-job.js +324 -0
  28. package/dist/k3-codex-role.js +4 -1
  29. package/dist/k3-helper-cli.d.ts +5 -0
  30. package/dist/k3-helper-cli.js +193 -0
  31. package/dist/local-usage.d.ts +47 -0
  32. package/dist/local-usage.js +230 -0
  33. package/dist/manifest.d.ts +5 -2
  34. package/dist/manifest.js +6 -6
  35. package/dist/planer-client.d.ts +45 -4
  36. package/dist/planer-client.js +120 -14
  37. package/dist/roles.d.ts +1 -1
  38. package/dist/select-fingerprint.d.ts +19 -0
  39. package/dist/select-fingerprint.js +46 -0
  40. package/dist/test-report.d.ts +9 -0
  41. package/dist/test-report.js +139 -0
  42. package/dist/tester-result-reader.d.ts +87 -0
  43. package/dist/tester-result-reader.js +122 -0
  44. package/docs/ENGINE-API.md +9 -1
  45. package/docs/README.en.md +58 -17
  46. package/docs/README.md +56 -17
  47. package/docs/RELEASE-0.1.0.md +28 -5
  48. package/helpers/ceo-client-launcher-mcp.mjs +76 -5
  49. package/package.json +6 -2
  50. 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.4)
1
+ # robisie — from account to accepted card (package 0.2.1)
2
2
 
3
3
  Polski: [README.md](README.md).
4
4
 
@@ -15,10 +15,12 @@ If the registry README is empty, use the guides shipped locally at `node_modules
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
 
22
+ The client engine HOLDs work when free space on the installation volume falls below **15 GiB**. Clearing an active HOLD needs **18 GiB** free (hysteresis) — in the 15–18 GiB band a fresh admission is allowed, but an active HOLD does not clear. `npx robisie doctor` prints the measured free space and both thresholds.
23
+
22
24
  <!-- sekcja: konto -->
23
25
  <a id="konto"></a>
24
26
  ## Account and first project
@@ -43,7 +45,15 @@ At https://robisie.app/dashboard/connect the human selects `worker` and a recogn
43
45
 
44
46
  `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.
45
47
 
46
- 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.
48
+ 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.
49
+
50
+ 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.
51
+
52
+ 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.
53
+
54
+ 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.
55
+
56
+ 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.
47
57
 
48
58
  <!-- sekcja: instalacja -->
49
59
  <a id="instalacja"></a>
@@ -66,17 +76,22 @@ node -e 'try {
66
76
  {
67
77
  set +x
68
78
  npm i robisie &&
69
- unset ROBISIE_KEY &&
79
+ unset ROBISIE_KEY ROBISIE_REVIEW_KEY &&
70
80
  npx robisie init --agent claude &&
71
81
  {
72
82
  if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
73
83
  [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
74
84
  [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
85
+ [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
86
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
87
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
88
+ ROBISIE_REVIEW_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" 2>/dev/null)" &&
89
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
75
90
  ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
76
91
  [ -n "$ROBISIE_KEY" ]; then
77
- export ROBISIE_KEY
92
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
78
93
  else
79
- 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
94
+ 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
80
95
  false
81
96
  fi
82
97
  } &&
@@ -95,11 +110,16 @@ set +x
95
110
  if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
96
111
  [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
97
112
  [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
113
+ [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
114
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
115
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
116
+ ROBISIE_REVIEW_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" 2>/dev/null)" &&
117
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
98
118
  ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
99
119
  [ -n "$ROBISIE_KEY" ]; then
100
- export ROBISIE_KEY
120
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
101
121
  else
102
- 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
122
+ 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
103
123
  false
104
124
  fi
105
125
  } &&
@@ -153,11 +173,16 @@ set +x
153
173
  if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
154
174
  [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
155
175
  [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
176
+ [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
177
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
178
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
179
+ ROBISIE_REVIEW_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" 2>/dev/null)" &&
180
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
156
181
  ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
157
182
  [ -n "$ROBISIE_KEY" ]; then
158
- export ROBISIE_KEY
183
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
159
184
  else
160
- 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
185
+ 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
161
186
  false
162
187
  fi
163
188
  }
@@ -191,7 +216,7 @@ The human runs this in a terminal with the correct environment, in the installat
191
216
  npx robisie doctor
192
217
  ```
193
218
 
194
- Doctor checks the contract, project reads, configuration, roles, helper startup and `ROBISIE_KEY`. It shows the map: null or mixed assignments give exit 1; return to the complete shared-provider assignment in init. “Wszystko działa” means those checks passed, without proving the whole work loop.
219
+ Doctor checks the contract, project reads, configuration, roles, helper startup, `ROBISIE_KEY`, and free disk on the installation volume. For disk it prints HOLD below 15 GiB and unblock hysteresis from 18 GiB; below 15 GiB it exits 1. It shows the map: null or mixed assignments give exit 1; return to the complete shared-provider assignment in init. “Wszystko działa” means those checks passed, without proving the whole work loop.
195
220
 
196
221
  Doctor runs the helper file via node, the agent via npx. `ROBISIE_PROJECT_CONTEXT` selects context later and does not change cwd for package lookup. Start the agent in the installation directory and ask it to list available tools from BOTH servers: `client-launch-context` (`get_launch_context`, `get_project_context`, `run_project_check`, `prepare_review`, `create_review_receipt`, `verify_stored_review`) and `ceo-client-launcher` (`spawn_builder`, `verify_review_receipt`). Result: both servers available with all these tools in that session. Do not call spawn_builder just as a probe. If a helper is missing, return to the installation cwd, check the local version and configuration, run init/doctor, then start a fresh agent session. Doctor alone does not confirm provider tool availability.
197
222
 
@@ -282,6 +307,7 @@ cp -p -- "$PWD/package.json" "$backup/project/package.json"
282
307
  cp -p -- "$PWD/package-lock.json" "$backup/project/package-lock.json"
283
308
  cp -p -- "$PWD/robisie.config.json" "$backup/project/robisie.config.json"
284
309
  cp -p -- "$config_home/robisie/key" "$backup/robisie/key"
310
+ cp -p -- "$config_home/robisie/review-key" "$backup/robisie/review-key"
285
311
  cp -p -- "$config_home/robisie/manifest.json" "$backup/robisie/manifest.json"
286
312
  cp -Rp -- "$config_home/robisie/backups/." "$backup/robisie/backups/"
287
313
  cp -Rp -- "$config_home/robisie/roles/codex/." "$backup/robisie/roles/codex/"
@@ -307,6 +333,7 @@ cp -p -- "$backup/project/package.json" "$PWD/package.json"
307
333
  cp -p -- "$backup/project/package-lock.json" "$PWD/package-lock.json"
308
334
  cp -p -- "$backup/project/robisie.config.json" "$PWD/robisie.config.json"
309
335
  cp -p -- "$backup/robisie/key" "$config_home/robisie/key"
336
+ cp -p -- "$backup/robisie/review-key" "$config_home/robisie/review-key"
310
337
  cp -p -- "$backup/robisie/manifest.json" "$config_home/robisie/manifest.json"
311
338
  cp -Rp -- "$backup/robisie/backups/." "$config_home/robisie/backups/"
312
339
  cp -Rp -- "$backup/robisie/roles/codex/." "$config_home/robisie/roles/codex/"
@@ -325,7 +352,7 @@ cp -p -- "$backup/profile/selected" "$profile"
325
352
  cp -p -- "$backup/entries/$entry_id" "$entry_path"
326
353
  ```
327
354
 
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:
355
+ 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:
329
356
 
330
357
  <!-- update:start -->
331
358
  ```sh
@@ -336,11 +363,16 @@ export XDG_CONFIG_HOME &&
336
363
  if [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
337
364
  [ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
338
365
  [ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
366
+ [ ! -L "$XDG_CONFIG_HOME/robisie/review-key" ] &&
367
+ [ -f "$XDG_CONFIG_HOME/robisie/review-key" ] &&
368
+ [ -r "$XDG_CONFIG_HOME/robisie/review-key" ] &&
369
+ ROBISIE_REVIEW_KEY="$(cat "$XDG_CONFIG_HOME/robisie/review-key" 2>/dev/null)" &&
370
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
339
371
  ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key" 2>/dev/null)" &&
340
372
  [ -n "$ROBISIE_KEY" ]; then
341
- export ROBISIE_KEY
373
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
342
374
  else
343
- 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
375
+ 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
344
376
  false
345
377
  fi
346
378
  } &&
@@ -367,11 +399,16 @@ export XDG_CONFIG_HOME &&
367
399
  if [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
368
400
  [ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
369
401
  [ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
402
+ [ ! -L "$XDG_CONFIG_HOME/robisie/review-key" ] &&
403
+ [ -f "$XDG_CONFIG_HOME/robisie/review-key" ] &&
404
+ [ -r "$XDG_CONFIG_HOME/robisie/review-key" ] &&
405
+ ROBISIE_REVIEW_KEY="$(cat "$XDG_CONFIG_HOME/robisie/review-key" 2>/dev/null)" &&
406
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
370
407
  ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key" 2>/dev/null)" &&
371
408
  [ -n "$ROBISIE_KEY" ]; then
372
- export ROBISIE_KEY
409
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
373
410
  else
374
- 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
411
+ 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
375
412
  false
376
413
  fi
377
414
  } &&
@@ -395,6 +432,8 @@ npm uninstall robisie
395
432
 
396
433
  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.
397
434
 
435
+ 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.
436
+
398
437
  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.
399
438
 
400
439
  <!-- sekcja: diagnoza -->
@@ -410,7 +449,7 @@ CLI messages remain in Polish. Match the message, then follow the English explan
410
449
  Generate a new worker key; in zsh/bash run `unset ROBISIE_KEY`, then init with the hidden prompt.
411
450
  - **brak-odczytu** — `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).`
412
451
  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).`
452
+ - **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.2.1 (obsługuje 1.x).`
414
453
  Example of a MAJOR mismatch: install a release compatible with the server contract.
415
454
  - **brak-env** — `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.`
416
455
  Check profile support; with --no-shell/another shell load the key file into the session environment as shown in init, then doctor.
@@ -431,3 +470,5 @@ After repair with an existing record, load the saved key as shown in Update befo
431
470
  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.
432
471
 
433
472
  Windows/WSL are unverified. Offline validation checks configuration structure, not project UUID, repo existence, model availability or provider execution.
473
+
474
+ 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.
package/docs/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # robisie — od konta do odebranej karty (paczka 0.1.4)
1
+ # robisie — od konta do odebranej karty (paczka 0.2.1)
2
2
 
3
3
  English: [README.en.md](README.en.md).
4
4
 
@@ -17,10 +17,12 @@ Jeśli README w rejestrze jest puste, użyj lokalnych przewodników w `node_modu
17
17
  <a id="wymagania"></a>
18
18
  ## Wymagania
19
19
 
20
- Człowiek przygotowuje Node.js 20+, npm, internet do zależności i robisie oraz program jednego dostawcy: Claude Code, Codex CLI albo OpenCode z własnym dostępem do AI. Sprawdź `node --version`, `npm --version` i wersję wybranego programu (`claude --version`, `codex --version` lub `opencode --version`). Jeśli programu nie ma w PATH, zainstaluj go według instrukcji dostawcy i sprawdź ponownie; sam katalog konfiguracji nie wystarcza. Windows/WSL są niezweryfikowane; poniższe przykłady używają ścieżek POSIX.
20
+ Człowiek przygotowuje Node.js 24+ (wydanie użyte przy sprawdzeniach: 24.3.0), npm, internet do zależności i robisie oraz program jednego dostawcy: Claude Code, Codex CLI albo OpenCode z własnym dostępem do AI. Starszy Node, np. 22, otrzymuje odmowę przed `init`, `doctor` i `factory run`. Silnik w paczce (`dist/engine/tick.cjs`) wymaga systemu Linux i jest uruchamiany przez `npx robisie factory run`; konfigurację silnika opisuje [ENGINE-CONFIG](ENGINE-CONFIG.md). Sprawdź `node --version`, `npm --version` i wersję wybranego programu (`claude --version`, `codex --version` lub `opencode --version`). Jeśli programu nie ma w PATH, zainstaluj go według instrukcji dostawcy i sprawdź ponownie; sam katalog konfiguracji nie wystarcza. Windows/WSL są niezweryfikowane; poniższe przykłady używają ścieżek POSIX.
21
21
 
22
22
  Przygotuj pusty katalog na dysku. Nie potrzebujesz strony ani własnego pliku `package.json`; przed instalacją utworzy go poniższy krok Node.js. To katalog pracy agentów, niezależny od projektu w panelu.
23
23
 
24
+ Silnik klienta wstrzymuje pracę (HOLD) gdy wolne miejsce na wolumenie instalacji spadnie poniżej **15 GiB**. Odblokowanie aktywnego HOLD wymaga histerezy **18 GiB** wolnego — w paśmie 15–18 GiB nowe wejście jest dopuszczone, ale aktywny HOLD nie znika. `npx robisie doctor` pokazuje zmierzoną wartość oraz oba progi.
25
+
24
26
  <!-- sekcja: konto -->
25
27
  <a id="konto"></a>
26
28
  ## Konto i pierwszy projekt
@@ -45,7 +47,13 @@ Człowiek w https://robisie.app/dashboard/connect wybiera `worker` i własną ro
45
47
 
46
48
  `worker` to minimalna droga: odczyt oraz tworzenie/zmiana projektów, ścieżek i kart, rezerwacja pracy; bez ustawiania `done` przez create/update. `observer` tylko czyta. Za każdym razem jawnie wybierz `worker`: kolejne klucze mają domyślnie `observer` (ekran pierwszego klucza może wskazywać worker); nie wywodź uprawnień z wartości domyślnej. `full` dodaje usuwanie oraz zamykanie spraw decyzyjnych; `owner_validator` ma ten sam poziom dostępu co full. `seeder` ma wąski dostęp do `get_task` i poprawnego zasiewu przez `append_detail`, bez `list_projects`/odczytu tablicy — nie uruchomi tego przewodnika.
47
49
 
48
- Paczka zapisuje **jeden klucz dla CEO, Buildera i Quality Officera** jako `ROBISIE_KEY`. Nazwa roli nie zmienia uprawnień. Nie używaj full jako obejścia odbioru `done`: właściciel odbiera wynik w panelu bez rozszerzania klucza agenta.
50
+ Paczka zapisuje **jeden klucz worker dla CEO, Buildera i Quality Officera** jako `ROBISIE_KEY`. Nazwa roli nie zmienia uprawnień. Nie używaj full jako obejścia odbioru `done`: właściciel odbiera wynik w panelu bez rozszerzania klucza agenta.
51
+
52
+ Wymagane są dwa osobne klucze: A (`ROBISIE_KEY`, worker) i B (`ROBISIE_REVIEW_KEY`, owner_validator). W https://robisie.app/dashboard/connect wygeneruj NOWY klucz B z rolą `owner_validator` i etykietą inną niż A: powtórzenie etykiety A rotuje A. Etykieta nie ogranicza klucza do projektu. B podaj poza rozmową w osobnym ukrytym pytaniu init albo przez bezpiecznie przygotowane ENV; `--key-stdin` pobiera tylko A. ENV B ma pierwszeństwo przed zapisanym `review-key` i pytaniem; otaczające spacje są błędem. Reinstalacja używa zapisanego B, jeśli ENV jest puste. Niepusty wadliwy B wymaga naprawy, bez zastępowania innym źródłem.
53
+
54
+ A i B są zapisywane osobno w `${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key` i `review-key` (pliki 0600, katalog 0700). B nie trafia do konfiguracji agentów/modeli, manifestu, argumentów, claimów ani komunikatów. Załaduj oba ENV także przy `--no-shell`. Przed pierwszym zadaniem uruchom zwykły `npx robisie doctor`: tryb `--engine-config` nie sprawdza kluczy. Przy brakującym lub niepoprawnym A doctor diagnozuje A; sprawdzanie B zaczyna dopiero, gdy A jest obecny i ma poprawny format. Brak B, B=A, zły format i nieudany odczyt B dają exit 1. B sprawdzane jest przez `initialize` + `list_projects`, bez mutacji danych biznesowych; liczniki auth mogą wzrosnąć. Odczyt nie potwierdza roli, wspólnego konta A/B ani polityki projektu.
55
+
56
+ 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.
49
57
 
50
58
  <!-- sekcja: instalacja -->
51
59
  <a id="instalacja"></a>
@@ -68,17 +76,22 @@ node -e 'try {
68
76
  {
69
77
  set +x
70
78
  npm i robisie &&
71
- unset ROBISIE_KEY &&
79
+ unset ROBISIE_KEY ROBISIE_REVIEW_KEY &&
72
80
  npx robisie init --agent claude &&
73
81
  {
74
82
  if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
75
83
  [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
76
84
  [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
85
+ [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
86
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
87
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
88
+ ROBISIE_REVIEW_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" 2>/dev/null)" &&
89
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
77
90
  ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
78
91
  [ -n "$ROBISIE_KEY" ]; then
79
- export ROBISIE_KEY
92
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
80
93
  else
81
- printf '%s\n' 'Nie można wczytać niepustego, zwykłego, czytelnego pliku klucza robisie.' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub unieważnieniu klucza wróć do Connect i init z ukrytym pytaniem. Nie wklejaj klucza do rozmowy.' >&2
94
+ printf '%s\n' 'Nie można wczytać obu niepustych, zwykłych, czytelnych plików kluczy robisie (key, review-key).' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub odmowie B podaj nowy owner_validator przez ROBISIE_REVIEW_KEY do init; --key-stdin wymienia tylko A. Nie wklejaj klucza do rozmowy.' >&2
82
95
  false
83
96
  fi
84
97
  } &&
@@ -97,11 +110,16 @@ set +x
97
110
  if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
98
111
  [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
99
112
  [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
113
+ [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
114
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
115
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
116
+ ROBISIE_REVIEW_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" 2>/dev/null)" &&
117
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
100
118
  ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
101
119
  [ -n "$ROBISIE_KEY" ]; then
102
- export ROBISIE_KEY
120
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
103
121
  else
104
- printf '%s\n' 'Nie można wczytać niepustego, zwykłego, czytelnego pliku klucza robisie.' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub unieważnieniu klucza wróć do Connect i init z ukrytym pytaniem. Nie wklejaj klucza do rozmowy.' >&2
122
+ printf '%s\n' 'Nie można wczytać obu niepustych, zwykłych, czytelnych plików kluczy robisie (key, review-key).' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub odmowie B podaj nowy owner_validator przez ROBISIE_REVIEW_KEY do init; --key-stdin wymienia tylko A. Nie wklejaj klucza do rozmowy.' >&2
105
123
  false
106
124
  fi
107
125
  } &&
@@ -155,11 +173,16 @@ set +x
155
173
  if [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
156
174
  [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
157
175
  [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" ] &&
176
+ [ ! -L "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
177
+ [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
178
+ [ -r "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" ] &&
179
+ ROBISIE_REVIEW_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/review-key" 2>/dev/null)" &&
180
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
158
181
  ROBISIE_KEY="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key" 2>/dev/null)" &&
159
182
  [ -n "$ROBISIE_KEY" ]; then
160
- export ROBISIE_KEY
183
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
161
184
  else
162
- printf '%s\n' 'Nie można wczytać niepustego, zwykłego, czytelnego pliku klucza robisie.' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub unieważnieniu klucza wróć do Connect i init z ukrytym pytaniem. Nie wklejaj klucza do rozmowy.' >&2
185
+ printf '%s\n' 'Nie można wczytać obu niepustych, zwykłych, czytelnych plików kluczy robisie (key, review-key).' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub odmowie B podaj nowy owner_validator przez ROBISIE_REVIEW_KEY do init; --key-stdin wymienia tylko A. Nie wklejaj klucza do rozmowy.' >&2
163
186
  false
164
187
  fi
165
188
  }
@@ -193,7 +216,7 @@ Człowiek w terminalu z poprawnym środowiskiem, w katalogu instalacji:
193
216
  npx robisie doctor
194
217
  ```
195
218
 
196
- Doctor sprawdza kontrakt, odczyt projektów, konfigurację, role, start pomocników i `ROBISIE_KEY`. Pokazuje mapę: null lub mieszana mapa daje exit 1; wróć do pełnego przypisania jednego dostawcy w sekcji init. „Wszystko działa” oznacza powodzenie tych kontroli, nie pełnej pętli pracy.
219
+ 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. „Wszystko działa” oznacza powodzenie tych kontroli, nie pełnej pętli pracy.
197
220
 
198
221
  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.
199
222
 
@@ -284,6 +307,7 @@ cp -p -- "$PWD/package.json" "$backup/project/package.json"
284
307
  cp -p -- "$PWD/package-lock.json" "$backup/project/package-lock.json"
285
308
  cp -p -- "$PWD/robisie.config.json" "$backup/project/robisie.config.json"
286
309
  cp -p -- "$config_home/robisie/key" "$backup/robisie/key"
310
+ cp -p -- "$config_home/robisie/review-key" "$backup/robisie/review-key"
287
311
  cp -p -- "$config_home/robisie/manifest.json" "$backup/robisie/manifest.json"
288
312
  cp -Rp -- "$config_home/robisie/backups/." "$backup/robisie/backups/"
289
313
  cp -Rp -- "$config_home/robisie/roles/codex/." "$backup/robisie/roles/codex/"
@@ -309,6 +333,7 @@ cp -p -- "$backup/project/package.json" "$PWD/package.json"
309
333
  cp -p -- "$backup/project/package-lock.json" "$PWD/package-lock.json"
310
334
  cp -p -- "$backup/project/robisie.config.json" "$PWD/robisie.config.json"
311
335
  cp -p -- "$backup/robisie/key" "$config_home/robisie/key"
336
+ cp -p -- "$backup/robisie/review-key" "$config_home/robisie/review-key"
312
337
  cp -p -- "$backup/robisie/manifest.json" "$config_home/robisie/manifest.json"
313
338
  cp -Rp -- "$backup/robisie/backups/." "$config_home/robisie/backups/"
314
339
  cp -Rp -- "$backup/robisie/roles/codex/." "$config_home/robisie/roles/codex/"
@@ -327,7 +352,9 @@ cp -p -- "$backup/profile/selected" "$profile"
327
352
  cp -p -- "$backup/entries/$entry_id" "$entry_path"
328
353
  ```
329
354
 
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:
355
+ Gdy tgz i wszystkie wybrane kopie są gotowe, aktualizuj. Init istniejącej instalacji używa zapisanych A i B; ENV ma pierwszeństwo. Jawny `--key-stdin` wymienia tylko A. Doctor i launcher nadal wymagają obu zmiennych środowiska. Wczytaj stary klucz PRZED init/doctor z tego samego XDG_CONFIG_HOME; osobne przypisanie przed export i `&&` zachowują błąd odczytu bez wydruku klucza:
356
+
357
+ Kopia i odtworzenie obejmują oba pliki key i review-key z prywatnymi uprawnieniami; przed init/doctor wczytaj oba odtworzone klucze. Uninstall raportuje osobno stan obu plików i usuwa je z zachowaniem dotychczasowej ochrony ewidencji oraz konfiguracji. Nie unieważnia żadnego klucza na serwerze.
331
358
 
332
359
  <!-- update:start -->
333
360
  ```sh
@@ -338,11 +365,16 @@ export XDG_CONFIG_HOME &&
338
365
  if [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
339
366
  [ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
340
367
  [ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
368
+ [ ! -L "$XDG_CONFIG_HOME/robisie/review-key" ] &&
369
+ [ -f "$XDG_CONFIG_HOME/robisie/review-key" ] &&
370
+ [ -r "$XDG_CONFIG_HOME/robisie/review-key" ] &&
371
+ ROBISIE_REVIEW_KEY="$(cat "$XDG_CONFIG_HOME/robisie/review-key" 2>/dev/null)" &&
372
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
341
373
  ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key" 2>/dev/null)" &&
342
374
  [ -n "$ROBISIE_KEY" ]; then
343
- export ROBISIE_KEY
375
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
344
376
  else
345
- printf '%s\n' 'Nie można wczytać niepustego, zwykłego, czytelnego pliku klucza robisie.' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub unieważnieniu klucza wróć do Connect i init z ukrytym pytaniem. Nie wklejaj klucza do rozmowy.' >&2
377
+ printf '%s\n' 'Nie można wczytać obu niepustych, zwykłych, czytelnych plików kluczy robisie (key, review-key).' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub odmowie B podaj nowy owner_validator przez ROBISIE_REVIEW_KEY do init; --key-stdin wymienia tylko A. Nie wklejaj klucza do rozmowy.' >&2
346
378
  false
347
379
  fi
348
380
  } &&
@@ -369,11 +401,16 @@ export XDG_CONFIG_HOME &&
369
401
  if [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
370
402
  [ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
371
403
  [ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
404
+ [ ! -L "$XDG_CONFIG_HOME/robisie/review-key" ] &&
405
+ [ -f "$XDG_CONFIG_HOME/robisie/review-key" ] &&
406
+ [ -r "$XDG_CONFIG_HOME/robisie/review-key" ] &&
407
+ ROBISIE_REVIEW_KEY="$(cat "$XDG_CONFIG_HOME/robisie/review-key" 2>/dev/null)" &&
408
+ [ -n "$ROBISIE_REVIEW_KEY" ] &&
372
409
  ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key" 2>/dev/null)" &&
373
410
  [ -n "$ROBISIE_KEY" ]; then
374
- export ROBISIE_KEY
411
+ export ROBISIE_KEY ROBISIE_REVIEW_KEY
375
412
  else
376
- printf '%s\n' 'Nie można wczytać niepustego, zwykłego, czytelnego pliku klucza robisie.' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub unieważnieniu klucza wróć do Connect i init z ukrytym pytaniem. Nie wklejaj klucza do rozmowy.' >&2
413
+ printf '%s\n' 'Nie można wczytać obu niepustych, zwykłych, czytelnych plików kluczy robisie (key, review-key).' 'Następny krok: sprawdź lokalnie plik klucza i jego odczyt; wyjaśnij link/katalog bez nadpisywania danych. Przy braku lub odmowie B podaj nowy owner_validator przez ROBISIE_REVIEW_KEY do init; --key-stdin wymienia tylko A. Nie wklejaj klucza do rozmowy.' >&2
377
414
  false
378
415
  fi
379
416
  } &&
@@ -412,7 +449,7 @@ Komunikaty CLI pozostają po polsku. Dopasuj komunikat, a potem wykonaj wskazan
412
449
  Wygeneruj nowy klucz worker; w zsh/bash wykonaj `unset ROBISIE_KEY`, potem init z ukrytym pytaniem.
413
450
  - **brak-odczytu** — `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).`
414
451
  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).`
452
+ - **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.2.1 (obsługuje 1.x).`
416
453
  Przykład niezgodnego MAJOR: zainstaluj wydanie zgodne z kontraktem serwera.
417
454
  - **brak-env** — `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.`
418
455
  Sprawdź obsługę profilu; przy --no-shell/innej powłoce wczytaj plik klucza do środowiska sesji jak w init, potem doctor.
@@ -433,3 +470,5 @@ Po naprawie przy istniejącej ewidencji wczytaj zapisany klucz według Aktualiza
433
470
  Instalator nie uruchamia sam usług w tle ani Buildera; po zgodzie operatora CEO może uruchomić Buildera przez `spawn_builder`. Pomocniki działają podczas sesji agenta, z kontekstem katalogu projektu (lub `ROBISIE_PROJECT_CONTEXT`). Instalator łączy się z robisie w celu sprawdzenia kontraktu i klucza; plik paczki nie zapewnia konta ani dostępu do dostawcy AI. Jedna wspólna tożsamość klucza nie daje trzech różnych poziomów uprawnień. Odbiór wymaga niezależnej recenzji, dowodów i zgody operatora.
434
471
 
435
472
  Windows/WSL są niezweryfikowane. Walidacja offline sprawdza strukturę konfiguracji, nie UUID projektu, istnienie repo, dostępność modeli ani uruchomienie dostawców.
473
+
474
+ Silnik paczki (`dist/engine/tick.cjs`) jest odrębny od instalatora: uruchamia go `npx robisie factory run --engine-config ./robisie.config.json` i tylko na Linuxie; na innym systemie polecenie odmawia z kodem 2 i komunikatem. Opcja `--once` uruchamia jeden takt bez przerwy i wyklucza jawne `--interval`. Każdy niezerowy wynik taktu zatrzymuje nadzorcę („Fabryka zatrzymana: …”) z jedną linią diagnozy na stderr; kod 2 to eskalacja (np. brak klucza B po receiver PASS, odmowa testera, STOP odbioru) wymagająca rozstrzygnięcia przed ponowieniem, a kod 78 wskazuje konfigurację do poprawy. Realne użycie u klienta na Linuxie zostanie udowodnione w odbiorze D9; na innych systemach nie ma natywnego dowodu uruchomienia silnika. Automatyczne plany FJ u klienta są zapowiedziane („wkrótce”), ale nie ma ich w tym wydaniu; selektor zwraca prawdziwy wynik.
@@ -2,36 +2,48 @@
2
2
 
3
3
  ## Polski
4
4
 
5
+ Wymagane są osobne A (`ROBISIE_KEY`, worker) i B (`ROBISIE_REVIEW_KEY`): w `/dashboard/connect` wygeneruj NOWY klucz `owner_validator` z etykietą inną niż A; powtórzenie etykiety A rotuje A. Init pobiera B z ENV, zapisanego `review-key` lub osobnego ukrytego pytania; `--key-stdin` dotyczy tylko A. Oba pliki są prywatne (0600/0700); B nie trafia do manifestu ani konfiguracji agentów/modeli. Profil i instrukcja --no-shell ładują oba ENV. Kopia/odtworzenie obejmuje oba pliki, a uninstall raportuje i usuwa oba z zachowaniem ochrony ewidencji i konfiguracji; nie unieważnia kluczy na serwerze.
6
+
7
+ Zwykły doctor przed pierwszym zadaniem wymaga poprawnego, różnego B i sprawdza odczyt przez `initialize` + `list_projects`; brak B, B=A, błędny format lub nieudany odczyt oznacza exit 1. Przy brakującym lub niepoprawnym A doctor diagnozuje A; sprawdzanie B zaczyna dopiero, gdy A jest obecny i ma poprawny format. Liczniki auth mogą wzrosnąć; dane biznesowe nie są mutowane. Każdy wynik doctor zawiera „Polityka enforced: NIE SPRAWDZONO — klient nie ma API jej odczytu”. Odczyt nie dowodzi roli, wspólnego konta ani enforced. Odmowa kontekstu projektu poprzedza doctor i zachowuje własną poradę. `doctor --engine-config` to osobna kontrola offline, bez sprawdzania kluczy.
8
+
5
9
  Klient łączy Claude Code, Codex CLI lub OpenCode z tablicą robisie. `init` instaluje konfigurację MCP, role CEO, Builder i Quality Officer oraz polecenia pomocników `client-launch-context` i `ceo-client-launcher`; `doctor` sprawdza połączenie i instalację, a `uninstall` usuwa zarejestrowane zmiany. Obce ustawienia i instrukcje pozostają; pierwsze kopie zapasowe zachowują stan sprzed instalacji.
6
10
 
7
- Wymagania 0.1: macOS lub Linux, Node.js >=20, npm i własny zainstalowany agent z dostępem do dostawcy AI; połączenie z robisie i klucz z Connect. Windows/WSL nie mają zweryfikowanego wsparcia. Klient rozumie kontrakt serwera 1.x, obecnie 1.0.0. Inny major, np. 2.0.0, jest odrzucany przed zapisem przez `init`; starszy klient nie obniża kontraktu serwera.
11
+ Wymagania: Node.js >=24 dla całej paczki (wydanie użyte przy sprawdzeniach: 24.3.0); starszy Node, np. 22, otrzymuje polską odmowę przed `init`, `doctor` i `factory run`. Instalator działa na macOS i Linux; silnik w paczce — `dist/engine/tick.cjs` — wymaga systemu Linux i jest uruchamiany przez `factory run`, które na innym systemie odmawia z kodem 2. Potrzebne są też npm, własny zainstalowany agent z dostępem do dostawcy AI, połączenie z robisie i klucz z Connect. Windows/WSL nie mają zweryfikowanego wsparcia. Klient rozumie kontrakt serwera 1.x, obecnie 1.0.0. Inny major, np. 2.0.0, jest odrzucany przed zapisem przez `init`; starszy klient nie obniża kontraktu serwera.
8
12
 
9
13
  Dostępność: instalacja z npm przez `npm i robisie` w katalogu pracy agenta; dalsze kroki opisuje [README](README.md).
10
14
 
11
15
  Po zgodzie człowieka na kartę potwierdzoną w `ready` CEO domyślnie uruchamia Buildera przez `ceo-client-launcher` → `spawn_builder`. Ręczny start w nowym terminalu jest wyłącznie jawnym wyborem operatora; błąd pomocnika wymaga zgłoszenia i naprawy przyczyny przed ponowieniem, bez automatycznego przejścia na ręczny start. Instalator sam nie startuje usług w tle ani Buildera.
12
16
 
13
- Ograniczenia: wszystkie trzy role muszą obecnie używać jednego dostawcy; mieszana mapa daje błąd `doctor`. Sam `doctor` nie potwierdza dostępności narzędzi obu pomocników w sesji dostawcy — sprawdź je zgodnie z README. W Claude Code niezależny Quality Officer przez `Agent(quality-officer-client)`, dowody i verified receipt poprzedzają `delivered`, a jawny odbiór operatora poprzedza `done`. OpenCode pozostaje w `in_review` niezależnie od dostępności Agent, bez wspieranego przejścia do `delivered`; pełny odbiór wymaga ścieżki Claude Code. Codex wymaga integracji Agent, niezależnej recenzji i verified receipt; brak Agent pozostawia kartę w `in_review` do naprawy CEO/CR. Builder nie recenzuje własnej pracy.
17
+ Ograniczenia: wszystkie trzy role muszą obecnie używać jednego dostawcy; mieszana mapa daje błąd `doctor`. Sam `doctor` nie potwierdza dostępności narzędzi obu pomocników w sesji dostawcy — sprawdź je zgodnie z README. W Claude Code niezależny Quality Officer przez `Agent(quality-officer-client)`, dowody i verified receipt poprzedzają `delivered`, a jawny odbiór operatora poprzedza `done`. OpenCode pozostaje w `in_review` niezależnie od dostępności Agent, bez wspieranego przejścia do `delivered`; pełny odbiór wymaga ścieżki Claude Code. Codex wymaga integracji Agent, niezależnej recenzji i verified receipt; brak Agent pozostawia kartę w `in_review` do naprawy CEO/CR. Builder nie recenzuje własnej pracy. Silnik paczki jest odrębny od instalatora: uruchamia go `npx robisie factory run --engine-config ./robisie.config.json` i tylko na Linuxie; każdy niezerowy wynik taktu zatrzymuje nadzorcę („Fabryka zatrzymana: …”) z jedną linią diagnozy na stderr, a kod 2 to eskalacja (np. brak klucza B po receiver PASS, odmowa testera, STOP odbioru) wymagająca rozstrzygnięcia przed ponowieniem; kod 78 wskazuje konfigurację do poprawy. Opcja `--once` uruchamia jeden takt bez przerwy i wyklucza jawne `--interval`. Konfigurację silnika opisuje [ENGINE-CONFIG](ENGINE-CONFIG.md). Automatyczne plany FJ u klienta są zapowiedziane („wkrótce”), ale nie ma ich w tym wydaniu; selektor zwraca prawdziwy wynik. Realne użycie u klienta na Linuxie zostanie udowodnione w odbiorze D9; na innych systemach niż Linux nie ma natywnego dowodu uruchomienia silnika.
14
18
 
15
19
  Biblioteki ESM w `dist/` obejmują parser konfiguracji `engine-config`, wyniki ról `role-results`, SDK tablicy `planer-client` ([API silnika](ENGINE-API.md)), rejestr ról, walidację zasiewu i reguły intencji, wybór i zakres pracy, ruchy i odzyskiwanie stanu, tożsamość prób/testera, środowisko Workera, źródła recenzji, wyniki CI oraz adaptery Claude/Codex/OpenCode i eksport sesji. `robisie.config.json` opisuje instancję: projekt, tory, katalog stanu i role; sekcja `engine` opisuje repo, gałąź, komendy, wymagane kontrole i sposób dostarczenia. Parser konfiguracji niczego nie uruchamia. Instalacja, import bibliotek i obecność pomocników nie dowodzą uruchomienia silnika ani pełnej autonomicznej pętli klienta.
16
20
 
21
+ Moduł `test-report` jest czystą kopią algorytmów fabryki bez jej importu; test AST sprawdza ich parytet. `passedVitestReport` ocenia strukturę raportu. Konsument pełnego PASS musi niezależnie sprawdzić exit=0 oraz brak nieobsłużonych błędów procesu (`Unhandled`); samo `success=true` w JSON nie dowodzi poprawnego zakończenia przebiegu.
22
+
17
23
  Powrót lokalny: zachowaj poprzedni tgz i kopię własnej konfiguracji; w tym samym projekcie zainstaluj go przez `npm i ./robisie-0.1.0.tgz`, potem `npx robisie init --agent <agent>` i `npx robisie doctor`. Najpierw sprawdź zgodność kontraktu. Test 0.1.0 → syntetyczne 0.1.1 → 0.1.0 jest lokalną próbą reinstalacji i powrotu, nie rollbackiem opublikowanych wydań. `npx robisie uninstall` usuwa zarejestrowane wpisy/bloki robisie, nie przywraca starych wpisów robisie; cofa niezmienione role, a zmienione przez użytkownika pozostawia z ostrzeżeniem. Backupy pozostają i mogą zawierać klucz — chroń je. Bez zapisu instalacji komenda nie usuwa pliku klucza; odmowa sprawdzenia konfiguracji Codex następuje przed usunięciem klucza, a po tym sprawdzeniu klucz jest usuwany nawet przy późniejszym błędzie. Kod różny od zera wymaga rozwiązania wskazanego problemu. Uninstall nie unieważnia klucza na serwerze (zrób to osobno w Connect); `npm uninstall robisie` usuwa paczkę z projektu, zgodnie z README.
18
24
 
19
25
  Ten dokument nie potwierdza tagu, GitHub Release ani publikacji npm.
20
26
 
21
27
  ## English
22
28
 
29
+ Separate A (`ROBISIE_KEY`, worker) and B (`ROBISIE_REVIEW_KEY`) are required: at `/dashboard/connect` generate a NEW `owner_validator` key with a label different from A; reusing A's label rotates A. Init reads B from ENV, saved `review-key` or a separate hidden prompt; `--key-stdin` applies only to A. Both files are private (0600/0700); B never enters the manifest or agent/model configuration. The profile and --no-shell instructions load both variables. Backup/restore covers both files, and uninstall reports and removes both under the ledger/configuration safeguards; it does not revoke server keys.
30
+
31
+ Run ordinary doctor before the first task. It requires valid, distinct B and checks reads using `initialize` + `list_projects`; missing B, B=A, bad format or failed reads mean exit 1. If A is missing or malformed, doctor diagnoses A; B checks begin only when A is present and has a valid format. Auth counters may increase; business data is not mutated. Every doctor result says “enforced policy: NOT CHECKED — the client has no API to read it” (CLI in Polish). Reads do not prove role, a shared account or enforced. Project-context refusal precedes doctor and keeps its own advice. `doctor --engine-config` is a separate offline check without key validation.
32
+
23
33
  The client connects Claude Code, Codex CLI or OpenCode to the robisie board. `init` installs MCP configuration, CEO, Builder and Quality Officer roles and the `client-launch-context` and `ceo-client-launcher` helper commands. `doctor` checks the connection and installation; `uninstall` removes recorded changes. Other settings and instructions survive; first backups retain the state before installation.
24
34
 
25
- Requirements for 0.1: macOS or Linux, Node.js >=20, npm, an installed agent with your own AI provider access, a robisie connection and a Connect key. Windows/WSL support is unverified. The client supports server contract 1.x, currently 1.0.0. `init` refuses another major, such as 2.0.0, before writing; an older client cannot downgrade the server contract.
35
+ Requirements: Node.js >=24 for the whole package (release used for checks: 24.3.0); an older Node, such as 22, receives a Polish refusal before `init`, `doctor` and `factory run`. The installer runs on macOS and Linux; the engine bundled in the package — `dist/engine/tick.cjs` — requires Linux and is started by `factory run`, which refuses with code 2 on any other system. Also required: npm, an installed agent with your own AI provider access, a robisie connection and a Connect key. Windows/WSL support is unverified. The client supports server contract 1.x, currently 1.0.0. `init` refuses another major, such as 2.0.0, before writing; an older client cannot downgrade the server contract.
26
36
 
27
37
  Availability: install from npm with `npm i robisie` in the agent working directory; follow [README](README.en.md) for the next steps.
28
38
 
29
39
  After human approval of a card confirmed in `ready`, the CEO starts the Builder by default through `ceo-client-launcher` → `spawn_builder`. Manual startup in a new terminal is only the operator's explicit choice; a helper error must be reported and its cause resolved before retrying, without automatically switching to manual startup. The installer itself starts neither background services nor the Builder.
30
40
 
31
- Limitations: all three roles currently need the same provider; `doctor` rejects mixed assignments. `doctor` alone does not confirm that both helpers' tools are available in the provider session — check them as described in README. In Claude Code, an independent Quality Officer through `Agent(quality-officer-client)`, evidence and a verified receipt precede `delivered`; explicit operator acceptance precedes `done`. OpenCode stays in `in_review` regardless of Agent availability, with no supported transition to `delivered`; full acceptance requires the Claude Code path. Codex requires Agent integration, independent review and a verified receipt; without Agent, the card stays in `in_review` pending CEO/CR repair. The Builder does not review its own work.
41
+ Limitations: all three roles currently need the same provider; `doctor` rejects mixed assignments. `doctor` alone does not confirm that both helpers' tools are available in the provider session — check them as described in README. In Claude Code, an independent Quality Officer through `Agent(quality-officer-client)`, evidence and a verified receipt precede `delivered`; explicit operator acceptance precedes `done`. OpenCode stays in `in_review` regardless of Agent availability, with no supported transition to `delivered`; full acceptance requires the Claude Code path. Codex requires Agent integration, independent review and a verified receipt; without Agent, the card stays in `in_review` pending CEO/CR repair. The Builder does not review its own work. The package engine is separate from the installer: it is started by `npx robisie factory run --engine-config ./robisie.config.json` and only on Linux; every nonzero tick result stops the supervisor („Fabryka zatrzymana: …”) with one diagnostic line on stderr, and code 2 means an escalation (e.g. missing B key after receiver PASS, tester refusal, acceptance STOP) that must be resolved before retrying; code 78 points to configuration repair. The `--once` option runs one tick without a pause and excludes an explicit `--interval`. The engine configuration is described in [ENGINE-CONFIG](ENGINE-CONFIG.md). Automatic FJ plans for customers are announced (“soon”) but are not in this release; the selector returns the true result. Real customer use on Linux will be proven in the D9 acceptance; on systems other than Linux there is no native proof of the engine running.
32
42
 
33
43
  The ESM libraries in `dist/` include the `engine-config` configuration parser, `role-results` role outcomes, the `planer-client` board SDK ([engine API](ENGINE-API.md)), role registry, seed validation and intent rules, selection and dispatch scope, outcome moves and recovery, attempt/tester identity, Worker environment, review source packets, CI results, Claude/Codex/OpenCode adapters and session export. `robisie.config.json` describes an instance: project, tracks, state directory and roles; its `engine` section describes the repository, branch, commands, required checks and delivery mode. Parsing configuration starts nothing. Installation, library imports and shipped helpers do not prove a running engine or a complete autonomous customer loop.
34
44
 
45
+ The `test-report` module is a pure copy of the factory algorithms without importing the factory; an AST test checks their parity. `passedVitestReport` evaluates report structure. A consumer claiming a full PASS must independently check exit=0 and the absence of unhandled process errors (`Unhandled`); `success=true` in JSON alone does not prove a successful run.
46
+
35
47
  Local return: retain the previous tgz and a copy of your configuration. Install it in the same project with `npm i ./robisie-0.1.0.tgz`, then run `npx robisie init --agent <agent>` and `npx robisie doctor`, checking contract compatibility first. The 0.1.0 → synthetic 0.1.1 → 0.1.0 test is a local reinstall and return rehearsal, not a rollback of published releases. `npx robisie uninstall` removes recorded robisie entries/blocks without restoring old robisie entries; it restores unchanged role files and leaves user-edited roles with a warning. Backups remain and may contain a key; protect them. Without an installation record, the key file is not removed; Codex configuration refusal happens before key deletion, while after that check the key is removed even if a later step fails. A nonzero exit requires resolving the reported problem. Uninstall does not revoke the server key (revoke it separately in Connect); `npm uninstall robisie` removes the project package, as described in README.
36
48
 
37
49
  This document does not confirm a tag, GitHub Release or npm publication.
@@ -54,7 +66,7 @@ export const config = parseConfig({
54
66
 
55
67
  ## Zawartość paczki / Package inventory
56
68
 
57
- Ścieżki bibliotek/CLI i pomocników; wpis przy launcherze wskazuje zarejestrowane narzędzie. Deklaracje `.d.ts` mogą towarzyszyć modułom JS. / Library/CLI and helper paths; the launcher entry names its registered tool. Type declarations may accompany JS modules.
69
+ Ścieżki bibliotek/CLI i pomocników; wpis przy launcherze wskazuje zarejestrowane narzędzie. Deklaracje `.d.ts` mogą towarzyszyć modułom JS. `dist/engine/tick.cjs` to samodzielny silnik paczki (plik CJS zbudowany z fabryki), uruchamiany przez `factory run` na Linuxie — odrębny od instalatora i od zestawu ESM. / Library/CLI and helper paths; the launcher entry names its registered tool. Type declarations may accompany JS modules. `dist/engine/tick.cjs` is the package's standalone engine (a CJS file built from the factory), started by `factory run` on Linux — separate from the installer and from the ESM set.
58
70
 
59
71
  <!-- release-surface:inventory:start -->
60
72
  - `dist/active-recovery.js`
@@ -63,19 +75,26 @@ export const config = parseConfig({
63
75
  - `dist/ci-failure-result.js`
64
76
  - `dist/claude-headless.js`
65
77
  - `dist/cli.js`
78
+ - `dist/codex-env.js`
66
79
  - `dist/commands.js`
67
80
  - `dist/constants.js`
68
81
  - `dist/context.js`
82
+ - `dist/delivery-local.js`
69
83
  - `dist/dependency-readiness.js`
84
+ - `dist/disk-guard.js`
70
85
  - `dist/dispatch-scope.js`
71
86
  - `dist/done-evidence.js`
72
87
  - `dist/engine-config.js`
88
+ - `dist/factory-run.js`
73
89
  - `dist/fsops.js`
74
90
  - `dist/helpers.js`
75
91
  - `dist/intent-rules/admission.js`
76
92
  - `dist/intent-rules/done-when-roles.js`
77
93
  - `dist/intent-rules/hooks.js`
94
+ - `dist/k3-codex-job.js`
78
95
  - `dist/k3-codex-role.js`
96
+ - `dist/k3-helper-cli.js`
97
+ - `dist/local-usage.js`
79
98
  - `dist/manifest.js`
80
99
  - `dist/mcp.js`
81
100
  - `dist/opencode-result.js`
@@ -90,11 +109,15 @@ export const config = parseConfig({
90
109
  - `dist/roles.js`
91
110
  - `dist/seed-package.js`
92
111
  - `dist/seed-validation.js`
112
+ - `dist/select-fingerprint.js`
93
113
  - `dist/selection-result.js`
94
114
  - `dist/sparse-policy.js`
95
115
  - `dist/task-mktemp.js`
116
+ - `dist/test-report.js`
96
117
  - `dist/tester-identity.js`
118
+ - `dist/tester-result-reader.js`
97
119
  - `dist/worker-env.js`
120
+ - `dist/engine/tick.cjs`
98
121
  - `helpers/ceo-client-launcher-mcp.mjs` → `spawn_builder`
99
122
  - `helpers/client-launch-context-mcp.mjs`
100
123
  - `helpers/client-spawn-session.sh`