robisie 0.5.44 → 0.5.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/roles.d.ts CHANGED
@@ -17,7 +17,7 @@ export interface Role {
17
17
  export declare function rolesDir(): string;
18
18
  export declare function parseRole(file: Role["file"], text: string): Role;
19
19
  export declare function loadRoles(dir?: string): Role[];
20
- export declare const MANAGED_LINE = "<!-- robisie:managed 0.5.44 \u2014 plik zarz\u0105dzany przez `npx robisie`; `npx robisie uninstall` go usunie -->";
20
+ export declare const MANAGED_LINE = "<!-- robisie:managed 0.5.46 \u2014 plik zarz\u0105dzany przez `npx robisie`; `npx robisie uninstall` go usunie -->";
21
21
  export type AgentFlavor = "claude" | "codex" | "opencode";
22
22
  /** How the operator starts the Builder for one card in its own session (the card id is not a secret). */
23
23
  export declare function builderStartCommand(flavor: AgentFlavor, codexRolePath?: string): string;
package/docs/README.en.md CHANGED
@@ -1,4 +1,4 @@
1
- # robisie — from account to accepted card (package 0.5.44) <!-- x-release-please-version -->
1
+ # robisie — from account to accepted card (package 0.5.46) <!-- x-release-please-version -->
2
2
 
3
3
  In the project directory with its engine configuration, run `npx robisie init`, then `npx robisie doctor`: init prepares the project goal and tester protection list, and doctor checks both inputs.
4
4
 
@@ -292,6 +292,8 @@ Limits: Landlock has a metadata protection gap and, before Linux kernel 6.2, a t
292
292
 
293
293
  Replace the entire `roleRegistry` with this Grok Worker example (keep the other installation settings from the Codex example). Reviewer and receiver use another provider. An absent `receiver-client` preserves historical Grok and refuses a Grok Worker. A shared provider requires separate explicit `requireIndependentProvider: false` for the relevant role: partial and the note “częściowa: bez niezależnego sprawdzenia” remain; the receiver exception requires protected `review_receipt.receiverIndependenceWaived=true` recorded by `accept_review`. Reviewer false does not waive receiver independence.
294
294
 
295
+ After changing the role pair, retry cards already in progress (“Retry work”) or restore the previous configuration. `HOLD clientPair` applies to the named card; other valid cards can continue.
296
+
295
297
  <!-- grok-worker-example:start -->
296
298
  ```json
297
299
  {
@@ -462,7 +464,7 @@ Missing/null/empty/unreadable `local_receiver.reason` or failure to identify an
462
464
 
463
465
  The assistant returns using key A (a key used for B cannot later record independent acceptance), a restricted account cannot leave `blocked`, a full active-card limit requires freeing a slot, and clicking the panel under `enforced` does not replace the assistant; on any tool refusal state stays unchanged and the owner receives the literal reason.
464
466
 
465
- - **Retry work (not acceptance of the same delivery):** open the Planner in the Dashboard (`https://robisie.app/dashboard/plugins/planer`) (“Projects” section), choose a project and card, then select “Ready” (`ready`) under “Stage”. The card returns to the agent's queue.
467
+ - **Retry work (not acceptance of the same delivery):** open the Planner in the Dashboard (`https://robisie.app/dashboard/plugins/planer`) (“Projects” section), choose a project and card, then select “Ready” (`ready`) under “Stage”. The card returns to the agent's queue. Without the panel, for `blocked` and `in_review` with `HOLD clientPair`: first call `get_task({id, include:[], fullDetails:true})`, then `update_task({id, status: "ready"})` using key A. After the write, read back the full card with the same `get_task` and verify `ready` and unchanged `details`. This retries work; returning the same delivery to acceptance uses the `blocked → in_review` path above. A tool refusal preserves state; do not change permissions or delete state.
466
468
  - **Abandon:** in the same card window, click “Delete”; at “Are you sure you want to delete this?” choose “Yes, delete”. **Deletion is irreversible — it cannot be undone.** The `masz-<first 8 characters of the card id>` branch with the agent's work remains in the repository.
467
469
 
468
470
  <!-- sekcja: aktualizacja -->
@@ -566,31 +568,14 @@ cp -p -- "$backup/entries/$entry_id" "$entry_path"
566
568
 
567
569
  Once the tgz and selected copies are ready, update. After login, init and doctor use A/B from the installation files and ignore different stale ENV with a warning. For manual installation without login, init reuses saved A/B with ENV-first; explicit `--key-stdin` selects input for A. Manual doctor requires both environment variables; agent credentials depend on the provider as described above. 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:
568
570
 
571
+ The normal update is `npx robisie update` (host: add `--engine-config /absolute/path/robisie.config.json`). The first interactive invocation visibly asks for consent and saves `update={consentedAt, enabled:true}` while preserving other configuration fields. Without consent or with `enabled:false`, background invocations exit 0 without changes. After consent, launchd `com.robisie.update` or `robisie-update.timer` runs the same command every 120 seconds; factory runs `factory run --once` on its own 120-second timer. The package prepares an exact npm version in a separate directory, verifies its build-id and integrity, then switches its private current pointer. Health requires two distinct fresh OK ticks with the expected loaded build-id within 1200 seconds (polling every 20 seconds). Failure starts a separate 1200-second health window for the previous version; both confirmed and unconfirmed rollback exit nonzero. New work prevents switching or rollback. A host with no board transport outside tick refuses explicitly; this command does not add a DB client. Read the private audit and attempts in `<stateDir>/update/`; a failed preparation also records the version. To retry only after resolving the cause, remove that version’s one line from `attempts.jsonl`. Deferral is not a failed attempt; after 7200 seconds it records one alarm. `AUTO-UPDATE.off` is not a product switch. Keep the private backup and separate archive restore below. Restart the assistant after roles refresh.
572
+
569
573
  <!-- update:start -->
570
574
  ```sh
571
575
  set +x
572
576
  XDG_CONFIG_HOME="$config_home" &&
573
577
  export XDG_CONFIG_HOME &&
574
- {
575
- if [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
576
- [ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
577
- [ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
578
- [ ! -L "$XDG_CONFIG_HOME/robisie/review-key" ] &&
579
- [ -f "$XDG_CONFIG_HOME/robisie/review-key" ] &&
580
- [ -r "$XDG_CONFIG_HOME/robisie/review-key" ] &&
581
- ROBISIE_REVIEW_KEY="$(cat "$XDG_CONFIG_HOME/robisie/review-key" 2>/dev/null)" &&
582
- [ -n "$ROBISIE_REVIEW_KEY" ] &&
583
- ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key" 2>/dev/null)" &&
584
- [ -n "$ROBISIE_KEY" ]; then
585
- export ROBISIE_KEY ROBISIE_REVIEW_KEY
586
- else
587
- 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
588
- false
589
- fi
590
- } &&
591
- npm i robisie@latest &&
592
- npx robisie init &&
593
- npx robisie doctor
578
+ npx robisie update
594
579
  ```
595
580
  <!-- update:end -->
596
581
 
@@ -598,7 +583,7 @@ Doctor checks the contract MAJOR; exit 0 also requires its other checks. Choose
598
583
 
599
584
  ### Return to the previous release
600
585
 
601
- 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.
586
+ 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. This emergency archive restore is separate from automatic pointer rollback.
602
587
 
603
588
  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:
604
589
 
package/docs/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # robisie — od konta do odebranej karty (paczka 0.5.44) <!-- x-release-please-version -->
1
+ # robisie — od konta do odebranej karty (paczka 0.5.46) <!-- x-release-please-version -->
2
2
 
3
3
  W katalogu projektu z konfiguracją silnika uruchom `npx robisie init`, potem `npx robisie doctor`: init przygotuje cel projektu i listę ochrony testera, a doctor sprawdzi oba wejścia.
4
4
 
@@ -339,6 +339,8 @@ Granice: Landlock ma lukę ochrony metadanych; przed jądrem Linux 6.2 ma też l
339
339
 
340
340
  Przykład zastępujący cały `roleRegistry` dla Workera Grok (pozostałe ustawienia instalacji pozostają jak w przykładzie Codexa). Recenzent i odbiorca mają innego dostawcę. Brak `receiver-client` zachowuje historycznego Groka i przy Workerze Grok oznacza odmowę. Wspólny dostawca wymaga osobnego jawnego `requireIndependentProvider: false` odpowiedniej roli: pozostaje partial i znak „częściowa: bez niezależnego sprawdzenia”; wyjątek odbiorcy wymaga chronionego `review_receipt.receiverIndependenceWaived=true` zapisanego przez `accept_review`. Recenzenckie false nie zwalnia niezależności odbiorcy.
341
341
 
342
+ Po zmianie pary ról karty w toku trzeba ponowić („Ponów pracę”) albo przywrócić poprzednią konfigurację. `HOLD clientPair` dotyczy wskazanej karty; pozostałe poprawne karty mogą pracować dalej.
343
+
342
344
  <!-- grok-worker-example:start -->
343
345
  ```json
344
346
  {
@@ -509,7 +511,7 @@ Brak/null/pusty/nieczytelny `local_receiver.reason` albo brak rozpoznania blokad
509
511
 
510
512
  Powrót wykonuje asystent z kluczem A (klucz użyty do wejścia B nie zapisze później niezależnego odbioru), konto ograniczone nie wyjdzie z `blocked`, pełny limit aktywnych kart wymaga zwolnienia miejsca, kliknięcie w panelu przy `enforced` nie zastępuje asystenta; przy każdej odmowie narzędzia stan zostaje, a właściciel dostaje dosłowny powód.
511
513
 
512
- - **Ponów pracę (nie odbiór tej samej dostawy):** otwórz Planer w panelu Dashboard (`https://robisie.app/dashboard/plugins/planer`) (sekcja „Projekty”), wybierz projekt i kartę. W sekcji „Etap” wybierz „Do wzięcia” (`ready`), a karta wróci do kolejki agenta.
514
+ - **Ponów pracę (nie odbiór tej samej dostawy):** otwórz Planer w panelu Dashboard (`https://robisie.app/dashboard/plugins/planer`) (sekcja „Projekty”), wybierz projekt i kartę. W sekcji „Etap” wybierz „Do wzięcia” (`ready`), a karta wróci do kolejki agenta. Bez panelu, dla `blocked` oraz `in_review` z `HOLD clientPair`: najpierw `get_task({id, include:[], fullDetails:true})`, następnie `update_task({id, status: "ready"})` kluczem A. Po zapisie odczytaj ponownie pełną kartę tym samym `get_task` i potwierdź `ready` oraz niezmienione `details`. To ponowienie pracy; powrót tej samej dostawy do odbioru używa opisanej wyżej drogi `blocked → in_review`. Odmowa narzędzia zachowuje stan; bez zmiany praw ani kasowania stanu.
513
515
  - **Porzuć:** w tym samym oknie karty kliknij „Usuń”; na pytanie „Na pewno usunąć?” wybierz „Tak, usuń”. **Usunięcie jest nieodwracalne — nie da się go cofnąć.** Gałąź `masz-<pierwsze 8 znaków id karty>` z pracą agenta zostaje w repozytorium.
514
516
 
515
517
  <!-- sekcja: aktualizacja -->
@@ -615,31 +617,14 @@ Gdy tgz i wszystkie wybrane kopie są gotowe, aktualizuj. Po login init i doctor
615
617
 
616
618
  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.
617
619
 
620
+ Zwykła aktualizacja to `npx robisie update` (host: dodaj `--engine-config /absolutna/sciezka/robisie.config.json`). Pierwsze interaktywne wywołanie pyta jawnie o zgodę i zapisuje `update={consentedAt, enabled:true}`, zachowując pozostałe pola konfiguracji. Bez zgody lub przy `enabled:false` wywołanie w tle kończy się kodem 0 bez zmian. Po zgodzie launchd `com.robisie.update` albo `robisie-update.timer` uruchamia tę samą komendę co 120 sekund; fabryka wykonuje `factory run --once` na osobnym cyklu 120 sekund. Paczka przygotowuje dokładną wersję npm w osobnym katalogu, sprawdza build-id i integralność, potem wymienia prywatny wskaźnik current. Zdrowie wymaga dwóch różnych świeżych taktów OK z loaded oczekiwanego build-id w 1200 sekund, odczytywanych co 20 sekund. Przy błędzie powrót ma osobne okno 1200 sekund dla starego wydania; zarówno potwierdzony, jak i niepotwierdzony powrót ma kod niezerowy. Nowa praca blokuje przełączenie lub powrót. Host bez transportu tablicy poza tick odmawia jawnie; komenda nie dodaje klienta DB. Prywatny audyt i próby znajdziesz w `<stateDir>/update/`; błąd przygotowania też zapisuje wersję. Aby ponowić po wyjaśnieniu przyczyny, usuń jedną linię tej wersji z `attempts.jsonl`. Odroczenie nie oznacza nieudanej próby; po 7200 sekund zapisuje jeden alarm. `AUTO-UPDATE.off` nie steruje produktem. Zachowaj prywatną kopię i osobny awaryjny restore archiwum. Po odświeżeniu ról uruchom ponownie asystenta.
621
+
618
622
  <!-- update:start -->
619
623
  ```sh
620
624
  set +x
621
625
  XDG_CONFIG_HOME="$config_home" &&
622
626
  export XDG_CONFIG_HOME &&
623
- {
624
- if [ ! -L "$XDG_CONFIG_HOME/robisie/key" ] &&
625
- [ -f "$XDG_CONFIG_HOME/robisie/key" ] &&
626
- [ -r "$XDG_CONFIG_HOME/robisie/key" ] &&
627
- [ ! -L "$XDG_CONFIG_HOME/robisie/review-key" ] &&
628
- [ -f "$XDG_CONFIG_HOME/robisie/review-key" ] &&
629
- [ -r "$XDG_CONFIG_HOME/robisie/review-key" ] &&
630
- ROBISIE_REVIEW_KEY="$(cat "$XDG_CONFIG_HOME/robisie/review-key" 2>/dev/null)" &&
631
- [ -n "$ROBISIE_REVIEW_KEY" ] &&
632
- ROBISIE_KEY="$(cat "$XDG_CONFIG_HOME/robisie/key" 2>/dev/null)" &&
633
- [ -n "$ROBISIE_KEY" ]; then
634
- export ROBISIE_KEY ROBISIE_REVIEW_KEY
635
- else
636
- 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
637
- false
638
- fi
639
- } &&
640
- npm i robisie@latest &&
641
- npx robisie init &&
642
- npx robisie doctor
627
+ npx robisie update
643
628
  ```
644
629
  <!-- update:end -->
645
630
 
@@ -647,7 +632,7 @@ Doctor sprawdza MAJOR kontraktu; exit 0 wymaga także pozostałych kontroli. Prz
647
632
 
648
633
  ### Powrót do poprzedniego wydania
649
634
 
650
- Przed nadpisaniem zachowaj późniejsze własne zmiany w NOWEJ prywatnej kopii (`umask 077`, np. `later="$(mktemp -d "$HOME/robisie-later.XXXXXX")"`). Powtórz przygotowanie katalogów i blok kopii, podstawiając `$later` zamiast `$backup`, bez zmiany starej kopii. Porównaj lokalnie i scal własne zmiany z kopią poprzedniego wydania; konfiguracja może zawierać klucz, więc bez publikowania diffu. Przy nieczytelnej konfiguracji, linku lub nierozstrzygniętym porównaniu przerwij nadpisywanie. Nie ma obietnicy automatycznego rollbacku.
635
+ Przed nadpisaniem zachowaj późniejsze własne zmiany w NOWEJ prywatnej kopii (`umask 077`, np. `later="$(mktemp -d "$HOME/robisie-later.XXXXXX")"`). Powtórz przygotowanie katalogów i blok kopii, podstawiając `$later` zamiast `$backup`, bez zmiany starej kopii. Porównaj lokalnie i scal własne zmiany z kopią poprzedniego wydania; konfiguracja może zawierać klucz, więc bez publikowania diffu. Przy nieczytelnej konfiguracji, linku lub nierozstrzygniętym porównaniu przerwij nadpisywanie. Ten awaryjny restore archiwum pozostaje osobny od automatycznego powrotu wskaźnika.
651
636
 
652
637
  Po porównaniu wykonaj wybrane komendy z bloku przywracania do tych samych celów, zachowując pominięcia z absent.txt. Polecenia katalogów kopiują zawartość przez `/.`, bez zagnieżdżania kolejnego katalogu; przed restore przygotuj sprawdzone katalogi celów, jeśli ich brakuje. Przy scalaniu `backups/` i `roles/codex/` nie usuwaj dodatkowych późniejszych plików. Najpierw przywróć `package.json` ORAZ `package-lock.json`. Potem w tym samym cwd wczytaj przywrócony stary klucz do ENV, zainstaluj zachowany zgodny tgz i dopiero wykonaj init oraz doctor:
653
638
 
@@ -91,6 +91,7 @@ export const config = parseConfig({
91
91
  - `dist/fsops.js`
92
92
  - `dist/git-commit.js`
93
93
  - `dist/helpers.js`
94
+ - `dist/installation-update.js`
94
95
  - `dist/intent-rules/admission.js`
95
96
  - `dist/intent-rules/done-when-roles.js`
96
97
  - `dist/intent-rules/hooks.js`
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "robisie",
3
- "version": "0.5.44",
3
+ "version": "0.5.46",
4
4
  "description": "Instalator klienta robisie: łączy agenta (Claude Code, Codex CLI, OpenCode) z tablicą robisie i instaluje role klienta.",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",