robisie 0.2.1 → 0.3.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.
package/docs/README.md CHANGED
@@ -1,4 +1,6 @@
1
- # robisie — od konta do odebranej karty (paczka 0.2.1)
1
+ # robisie — od konta do odebranej karty (paczka 0.3.0)
2
+
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.
2
4
 
3
5
  English: [README.en.md](README.en.md).
4
6
 
@@ -7,7 +9,7 @@ English: [README.en.md](README.en.md).
7
9
  <!-- sekcja: dostepnosc -->
8
10
  ## Dostępność
9
11
 
10
- Konto i klucz są potrzebne do init i pracy ról. Osobne wejście to walidacja offline, gdy CLI jest dostępne: nie sprawdza instalacji, nie uruchamia dostawców i nie wymaga podawania UUID projektu. Osobno `npx robisie doctor --engine-config ./robisie.config.json` sprawdza offline tylko strukturę konfiguracji: nie potwierdza UUID projektu, repo, modeli ani uruchomienia dostawców. Przewodniki z tej paczki znajdziesz lokalnie w `node_modules/robisie/docs/README.md` i `node_modules/robisie/docs/README.en.md`; nie trzeba pobierać ich ze strony.
12
+ Konto i klucz są potrzebne do init i pracy ról. Osobne wejście to walidacja offline, gdy CLI jest dostępne: nie sprawdza instalacji, nie uruchamia dostawców i nie wymaga podawania UUID projektu. Osobno `npx robisie doctor --engine-config ./robisie.config.json` sprawdza offline strukturę konfiguracji i wejścia instalacji lokalnej: nie potwierdza UUID projektu, repo, modeli ani uruchomienia dostawców. Przewodniki z tej paczki znajdziesz lokalnie w `node_modules/robisie/docs/README.md` i `node_modules/robisie/docs/README.en.md`; nie trzeba pobierać ich ze strony.
11
13
 
12
14
  Zainstaluj robisie z npm w przygotowanym katalogu; w nim uruchamiaj dalsze polecenia i sesje agentów. [Przygotowanie](#wymagania) → [konto](#konto) → [klucz](#klucz) → [instalacja](#instalacja) → [odbiór](#recenzja-i-odbior).
13
15
 
@@ -55,6 +57,16 @@ A i B są zapisywane osobno w `${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key` i
55
57
 
56
58
  Każdy wynik doctor zawiera `! Polityka enforced: NIE SPRAWDZONO — klient nie ma API jej odczytu.` Odmowa kontekstu projektu następuje przed doctor i ma własną poradę. Zielony doctor nie oznacza aktywacji enforced. Przy błędzie B sprawdź dostęp do Connect i wystawienie owner_validator; awaria sieci nie dowodzi unieważnienia. Ponów init z poprawnym B w ENV, potem doctor. Zmiana polityki wymaga osobnej uprawnionej czynności operatora.
57
59
 
60
+ ### Logowanie kodem: npx robisie login
61
+
62
+ Zamiast przepisywać klucze z Connect możesz sparować instalację jednym poleceniem w katalogu instalacji: `npx robisie login`. Polecenie wypisuje kod i link do https://robisie.app/dashboard/connect/device. Ty albo Twój agent, zalogowany na to konto w przeglądarce, porównujecie kod z terminalem, ponownie potwierdzacie logowanie i zatwierdzacie oba klucze naraz: A (worker) i B (owner_validator — pełne uprawnienia, w tym usuwanie). Serwer zawsze wydaje parę A+B. Klucze trafiają prosto do plików `key` i `review-key` instalacji (0600, katalog 0700): nie przechodzą przez ekran, schowek, rozmowę ani historię poleceń.
63
+
64
+ Kod wyjścia 0 oznacza, że para jest zapisana i potwierdzona. Kod 2 oznacza, że parowanie czeka na zatwierdzenie — to jeszcze nie jest zalogowanie; wznów je tym samym `npx robisie login`, zanim kod wygaśnie (10 minut). Kod 1 to błąd z jednym następnym krokiem. `npx robisie login --no-wait` tylko wypisuje kod i link; `--timeout` ustala, ile sekund czekać (domyślnie 540). Bez kluczy, bez terminala i bez `--key-stdin` init sam zaczyna od tego logowania.
65
+
66
+ Po zalogowaniu init, doctor i `npx robisie factory run` biorą A i B z plików instalacji. Stara wartość ROBISIE_KEY lub ROBISIE_REVIEW_KEY w środowisku jest wtedy ignorowana z ostrzeżeniem, bez wypisywania jej treści — otwórz nowy terminal. Doctor nie wymaga ROBISIE_REVIEW_KEY w środowisku takiej instalacji. Naraz działa jedno polecenie robisie: drugie odmawia komunikatem „Inna operacja robisie trwa”. Przerwany zapis pary (np. brak miejsca na dysku) dokańcza następne polecenie; do tego czasu żadne polecenie nie używa kluczy z plików. Instalacje z kluczami wklejonymi z Connect działają jak dotąd.
67
+
68
+ Wersja dla testerów to jedna strefa zaufania: na tym komputerze agent wykonujący zadania technicznie ma dostęp także do klucza odbioru (B). Uruchamiaj na nim tylko agentów, którym ufasz jak sobie.
69
+
58
70
  <!-- sekcja: instalacja -->
59
71
  <a id="instalacja"></a>
60
72
  ## Instalacja z npm
@@ -216,7 +228,7 @@ Człowiek w terminalu z poprawnym środowiskiem, w katalogu instalacji:
216
228
  npx robisie doctor
217
229
  ```
218
230
 
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.
231
+ Doctor sprawdza kontrakt, odczyt projektów, konfigurację, role, start pomocników, `ROBISIE_KEY` oraz wolne miejsce na dysku instalacji. Przy dysku wypisuje HOLD poniżej 15 GiB i histerezę odblokowania od 18 GiB; poniżej 15 GiB kończy się exit 1. Pokazuje mapę: null lub mieszana mapa daje exit 1; wróć do pełnego przypisania jednego dostawcy w sekcji init. „Powyższe kontrole przeszły” oznacza powodzenie tych kontroli, nie pełnej pętli pracy. Linia „Gotowość wykonawców Codex–Grok” mówi osobno, czy sprawdzono logowanie Codex (`codex login status`) i Groka (`grok models`, więc tylko „prawdopodobnie zalogowany”).
220
232
 
221
233
  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.
222
234
 
@@ -255,6 +267,13 @@ W innych sesjach CEO, w tym Codex, przejście do delivered wymaga niezależnej r
255
267
 
256
268
  Właściciel projektu może w panelu: Dashboard → Planer → karta → Etap wybrać „Zrobione” i przesunąć `delivered` do `done`, także przy kluczu agenta `worker`. Dla opisanej pierwszej karty serwer nie wymusza zapisanej akceptacji ani dowodów przed zmianą na `done`: panel pozwala właścicielowi wybrać „Zrobione” także bez nich. Zrób to dopiero po sprawdzeniu wyniku i jawnym odbiorze. Panel nie edytuje szczegółów `details`; recenzję i dowody zapisuje się przez obsługiwany przepływ narzędzi tablicy. Sama instrukcja nie dowodzi, że ten przebieg przeszedł już u klienta.
257
269
 
270
+ ### Karta zablokowana: ponów albo porzuć
271
+
272
+ Karta w etapie „Zablokowane” czeka na decyzję właściciela. Ochrona zakresu jest celowa: klucz roboczy A (worker) nie zamknie karty — próba ustawienia `done` kluczem A kończy się odmową 403. `done` jest zarezerwowane dla odbioru wyniku z dowodem, nie do zwalniania zakresu. Nie rozszerzaj klucza A ani nie zmieniaj ról, żeby obejść odmowę.
273
+
274
+ - **Ponów:** otwórz Planer w panelu Dashboard (`https://robisie.app/dashboard/plugins/planer`) (sekcja „Projekty”), wybierz projekt i kartę. W sekcji „Etap” wybierz „Do wzięcia” (`ready`), a karta wróci do kolejki agenta.
275
+ - **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.
276
+
258
277
  <!-- sekcja: aktualizacja -->
259
278
  ## Aktualizacja i prywatna kopia
260
279
 
@@ -444,12 +463,12 @@ Bez instalacji zacznij od konta i Connect → init; samo ponawianie doctor nie z
444
463
  Komunikaty CLI pozostają po polsku. Dopasuj komunikat, a potem wykonaj wskazaną czynność:
445
464
 
446
465
  - **brak-klucza** — `Brak klucza robisie.`
447
- Wygeneruj klucz w Connect i przekaż go do init.
466
+ Wygeneruj klucz w Connect i przekaż go do init albo sparuj instalację: `npx robisie login`.
448
467
  - **odrzucony-klucz** — `Serwer robisie odrzucił klucz (nieważny albo unieważniony).`
449
468
  Wygeneruj nowy klucz worker; w zsh/bash wykonaj `unset ROBISIE_KEY`, potem init z ukrytym pytaniem.
450
469
  - **brak-odczytu** — `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).`
451
470
  Wybierz worker w Connect; `unset ROBISIE_KEY`, potem init z ukrytym pytaniem.
452
- - **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.2.1 (obsługuje 1.x).`
471
+ - **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.3.0 (obsługuje 1.x).`
453
472
  Przykład niezgodnego MAJOR: zainstaluj wydanie zgodne z kontraktem serwera.
454
473
  - **brak-env** — `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.`
455
474
  Sprawdź obsługę profilu; przy --no-shell/innej powłoce wczytaj plik klucza do środowiska sesji jak w init, potem doctor.
@@ -469,6 +488,6 @@ Po naprawie przy istniejącej ewidencji wczytaj zapisany klucz według Aktualiza
469
488
 
470
489
  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.
471
490
 
472
- Windows/WSL są niezweryfikowane. Walidacja offline sprawdza strukturę konfiguracji, nie UUID projektu, istnienie repo, dostępność modeli ani uruchomienie dostawców.
491
+ Windows/WSL są niezweryfikowane. Walidacja offline sprawdza strukturę konfiguracji i wejścia instalacji lokalnej, nie UUID projektu, istnienie repo, dostępność modeli ani uruchomienie dostawców.
473
492
 
474
493
  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.
@@ -81,12 +81,15 @@ export const config = parseConfig({
81
81
  - `dist/context.js`
82
82
  - `dist/delivery-local.js`
83
83
  - `dist/dependency-readiness.js`
84
+ - `dist/device-login.js`
84
85
  - `dist/disk-guard.js`
85
86
  - `dist/dispatch-scope.js`
86
87
  - `dist/done-evidence.js`
87
88
  - `dist/engine-config.js`
89
+ - `dist/engine-inputs.js`
88
90
  - `dist/factory-run.js`
89
91
  - `dist/fsops.js`
92
+ - `dist/git-commit.js`
90
93
  - `dist/helpers.js`
91
94
  - `dist/intent-rules/admission.js`
92
95
  - `dist/intent-rules/done-when-roles.js`
@@ -95,6 +98,7 @@ export const config = parseConfig({
95
98
  - `dist/k3-codex-role.js`
96
99
  - `dist/k3-helper-cli.js`
97
100
  - `dist/local-usage.js`
101
+ - `dist/login.js`
98
102
  - `dist/manifest.js`
99
103
  - `dist/mcp.js`
100
104
  - `dist/opencode-result.js`
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "robisie",
3
- "version": "0.2.1",
3
+ "version": "0.3.0",
4
4
  "description": "Instalator klienta robisie: łączy agenta (Claude Code, Codex CLI, OpenCode) z tablicą robisie i instaluje role klienta.",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",