robisie 0.4.7 → 0.5.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.
- package/CHANGELOG.md +16 -0
- package/README.md +15 -7
- package/dist/cli.js +2 -2
- package/dist/constants.d.ts +1 -1
- package/dist/constants.js +1 -1
- package/dist/engine/build-id.json +1 -1
- package/dist/engine/bundle-report.json +1 -1
- package/dist/engine/tick.cjs +75 -13
- package/dist/engine-config.d.ts +15 -0
- package/dist/engine-config.js +25 -0
- package/dist/factory-run.js +20 -13
- package/dist/roles.d.ts +1 -1
- package/docs/ENGINE-CONFIG.md +55 -0
- package/docs/README.en.md +86 -11
- package/docs/README.md +86 -11
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# Historia zmian klienta / Client changelog
|
|
2
2
|
|
|
3
|
+
## [0.5.1](https://github.com/chuppa12/robisie-app/compare/client-v0.5.0...client-v0.5.1) (2026-11-11)
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
### Factory Cards
|
|
7
|
+
|
|
8
|
+
* praca workera task-mwbvh8b1-qxbwrg (auto-commit) ([b6750e8](https://github.com/chuppa12/robisie-app/commit/b6750e840e4b3335b6c1b453b978b47392c05992))
|
|
9
|
+
* praca workera task-mwbw8t6k-dvfd29 (auto-commit) ([a615158](https://github.com/chuppa12/robisie-app/commit/a61515869c37ebe20ed060c1117d4a5e2b069ed7))
|
|
10
|
+
|
|
11
|
+
## [0.5.0](https://github.com/chuppa12/robisie-app/compare/client-v0.4.7...client-v0.5.0) (2026-11-11)
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
### Features
|
|
15
|
+
|
|
16
|
+
* **maszynista:** Z3 — host uruchamia takt z wydanej paczki (engine.hostPaths, instalator bez ambientu, pin E1) ([a44b862](https://github.com/chuppa12/robisie-app/commit/a44b8623adf91cb6e366b9f0bff98df86aa7c4e6))
|
|
17
|
+
* **maszynista:** Z3 — host uruchamia takt z wydanej paczki (engine.hostPaths, instalator launchd bez ambientu, pin E1) ([c5313be](https://github.com/chuppa12/robisie-app/commit/c5313beb590893c897c4419428c60270454bbd4c))
|
|
18
|
+
|
|
3
19
|
## [0.4.7](https://github.com/chuppa12/robisie-app/compare/client-v0.4.6...client-v0.4.7) (2026-11-11)
|
|
4
20
|
|
|
5
21
|
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
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
|
|
|
5
|
-
Przewodniki: [PL — konto → odbiór → odinstalowanie](docs/README.md) · [EN — account → acceptance → uninstall](docs/README.en.md). Przygotuj Node.js 24+ (wydanie użyte przy sprawdzeniach: 24.3.0), npm, program jednego dostawcy AI oraz pusty katalog; silnik w paczce (`dist/engine/tick.cjs`) wymaga systemu Linux. Nie potrzebujesz strony ani własnego pliku `package.json` — utworzy go poniższy krok Node.js przed instalacją. Zacznij od konta i projektu w panelu. Projekt w panelu i katalog na dysku to osobne rzeczy; CEO wymaga dokładnie jednego projektu z `list_projects`.
|
|
5
|
+
Przewodniki: [PL — konto → odbiór → odinstalowanie](docs/README.md) · [EN — account → acceptance → uninstall](docs/README.en.md). Przygotuj Node.js 24+ (wydanie użyte przy sprawdzeniach: 24.3.0), npm, program jednego dostawcy AI oraz pusty katalog; silnik w paczce (`dist/engine/tick.cjs`) dla klienta wymaga systemu Linux. Jawny host Robisie (`mode: "host"`, `pr|delivered`) obsługuje także macOS; konfigurację i granice opisuje ENGINE-CONFIG. Nie potrzebujesz strony ani własnego pliku `package.json` — utworzy go poniższy krok Node.js przed instalacją. Zacznij od konta i projektu w panelu. Projekt w panelu i katalog na dysku to osobne rzeczy; CEO wymaga dokładnie jednego projektu z `list_projects`.
|
|
6
6
|
|
|
7
7
|
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. Lokalne przewodniki są w `node_modules/robisie/docs/`.
|
|
8
8
|
|
|
@@ -21,7 +21,7 @@ Jeśli trasa przekierowała na /dashboard bez Planera, znajdź „Zacznij od pie
|
|
|
21
21
|
<!-- agent-consent:start -->
|
|
22
22
|
### Instrukcja dla agenta — jedna zgoda na przebieg
|
|
23
23
|
|
|
24
|
-
Na początku poproś raz o zgodę na nazwany przebieg i jego granice: własne konto, wygenerowanie klucza, bezpieczny lokalny zapis klucza, init oraz pierwszą uzgodnioną kartę (cel, katalog, zakres zapisu i kryteria wyniku).
|
|
24
|
+
Na początku poproś raz o zgodę na nazwany przebieg i jego granice: własne konto, wygenerowanie klucza, bezpieczny lokalny zapis klucza, init oraz pierwszą uzgodnioną kartę (cel, katalog, zakres zapisu i kryteria wyniku). Przed prośbą o zgodę wybierz z właścicielem lokalną kartę `greet.cjs` albo ręczną `wynik.txt`; granice muszą odpowiadać wybranemu przykładowi.
|
|
25
25
|
|
|
26
26
|
Jeśli właściciel już udzielił zgody na ten przebieg, nie pytaj ponownie przy tych krokach; kontynuuj w ustalonych granicach. Brak zgody, null, pusta lub niejasna odpowiedź albo zmiana zakresu wymagają pytania przed zależnym krokiem; wykonuj dalej niezależne dozwolone czynności. Odmowę uszanuj: nie wykonuj odmówionych kroków. Zgoda nie omija chronionych potwierdzeń człowieka ani dostawcy; po takim potwierdzeniu kontynuuj. Klucz pozostaje poza rozmową, kartą, argumentami i historią poleceń; gdy bezpieczny zapis lub przekazanie nie jest dostępne, człowiek używa ukrytego pytania init. Cudza otwarta sesja nie daje dostępu do jej konta. Po pracy nadal obowiązują niezależna recenzja oraz osobny końcowy odbiór wyniku przez właściciela.
|
|
27
27
|
<!-- agent-consent:end -->
|
|
@@ -30,9 +30,17 @@ Trzy role instalatora używają jednego dostawcy: CEO (`ceo`), Builder (`builder
|
|
|
30
30
|
|
|
31
31
|
Ustawienia instalatora `ceo`/`builder`/`quality` (CEO/Builder/Quality Officer) są odrębne od rejestru wykonania `roleRegistry`: `worker-client`, `lead-client`, `reviewer-client`, `tester-client`. Nazwy projektu `coordinator`/`owner`/`planner`/`advisor` to jeszcze inne ustawienie. Nie ma automatycznej konwersji między nimi; rejestr nie włącza mieszanego wykonywania ról instalatora.
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
Przy ręcznej instalacji z Connect 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.
|
|
34
34
|
|
|
35
|
-
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.
|
|
35
|
+
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. Przy ręcznej instalacji 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.
|
|
36
|
+
|
|
37
|
+
<!-- credential-sources:start -->
|
|
38
|
+
Po `login` polecenia `init`, `doctor` i `factory run` używają A/B z plików `key` i `review-key`. Różny niepusty stary ENV jest ignorowany z ostrzeżeniem bez ujawniania wartości; brak lub uszkodzenie plików wymaga naprawy, nie fallbacku do ENV. Dotyczy to poleceń robisie, a nie osobnych sesji agentów.
|
|
39
|
+
|
|
40
|
+
Instalacja ręczna z Connect (bez login) zachowuje ENV-first: poprawny ENV ma pierwszeństwo przed zapisanym kluczem. Dla A przy pustym ENV init używa zapisanego pliku, jeśli istnieje instalacja i nie wybrano `--key-stdin`, potem ukrytego pytania lub jawnego stdin; dla B używa zapisanego pliku istniejącej instalacji, potem ukrytego pytania. Niepusty wadliwy klucz, błąd odczytu lub dowiązanie wymagają naprawy, bez zastępowania innym źródłem. Ręczny doctor wymaga obu ENV, także przy `--no-shell`.
|
|
41
|
+
|
|
42
|
+
Osobni agenci: Claude Code używa nagłówka `Authorization` zapisanego przez init w prywatnej konfiguracji; Codex używa `bearer_token_env_var = "ROBISIE_KEY"`, a OpenCode referencji `{env:ROBISIE_KEY}`. Codex/OpenCode wymagają aktualnego A w środowisku sesji także po login; wczytaj je bez wydruku według przepisu init. B nie jest kluczem konfiguracji agentów. Po zmianie kluczy ponów init dla wybranego dostawcy i rozpocznij nową sesję.
|
|
43
|
+
<!-- credential-sources:end -->
|
|
36
44
|
|
|
37
45
|
Gdy klucz A widzi dokładnie jeden projekt, doctor odczytuje jego `reviewPolicy` przez `list_projects`: `enforced` daje „✓ Polityka enforced: TAK”, `legacy` ostrzega, że `accept_review` będzie odmawiane i wymaga ustawienia enforced przez operatora. Starszy serwer bez pola lub `null` daje „NIE SPRAWDZONO — serwer nie zwraca polityki”, błąd odczytu — „NIE SPRAWDZONO — odczyt nieudany”. Linia jest informacyjna i nie zmienia exit. Odmowa kontekstu projektu następuje przed doctor i ma własną poradę. Klient tylko odczytuje politykę, nie aktywuje enforced; zmienia ją uprawniony operator.
|
|
38
46
|
|
|
@@ -163,9 +171,9 @@ npm i robisie@latest
|
|
|
163
171
|
|
|
164
172
|
### Aktualizacja po init
|
|
165
173
|
|
|
166
|
-
Aktualizuj w katalogu instalacji po prywatnej kopii opisanej w przewodnikach, z tym samym XDG_CONFIG_HOME i CODEX_HOME. `npx robisie init` odświeża zapisanych agentów i mapę ról, używając poprawnego zapisanego klucza bez ponownego wpisywania. ROBISIE_KEY ma pierwszeństwo; jawny `--key-stdin` zachowuje tor pytania/stdin i umożliwia wymianę klucza. Bez zapisanej instalacji lub przy braku/pustym kluczu init korzysta z dotychczasowego pytania. Wadliwy niepusty klucz, błąd odczytu lub dowiązanie wymagają naprawy lokalnej, bez nadpisywania.
|
|
174
|
+
Aktualizuj w katalogu instalacji po prywatnej kopii opisanej w przewodnikach, z tym samym XDG_CONFIG_HOME i CODEX_HOME. `npx robisie init` odświeża zapisanych agentów i mapę ról, używając poprawnego zapisanego klucza bez ponownego wpisywania. W ręcznej instalacji bez login ROBISIE_KEY ma pierwszeństwo; jawny `--key-stdin` zachowuje tor pytania/stdin i umożliwia wymianę klucza. Bez zapisanej instalacji lub przy braku/pustym kluczu init korzysta z dotychczasowego pytania. Wadliwy niepusty klucz, błąd odczytu lub dowiązanie wymagają naprawy lokalnej, bez nadpisywania.
|
|
167
175
|
|
|
168
|
-
Doctor podaje rzeczywiste wersje starych pomocników i markerów ról oraz wersję paczki; wskazane init aktualizuje je przez zwykły zapis z kopiami.
|
|
176
|
+
Doctor podaje rzeczywiste wersje starych pomocników i markerów ról oraz wersję paczki; wskazane init aktualizuje je przez zwykły zapis z kopiami. Po login doctor używa plików A/B z ostrzeżeniem przy różnym starym ENV; ręczny doctor wymaga obu ENV, a osobni agenci używają źródeł zależnych od dostawcy opisanych wyżej. Poniższy przykład usuwa wcześniejszy ROBISIE_KEY z sesji, aby init użył zapisanego pliku; po init wczytuje ENV dla doctor i agentów, bez xtrace i bez wydruku:
|
|
169
177
|
|
|
170
178
|
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.
|
|
171
179
|
|
|
@@ -233,7 +241,7 @@ Uruchom `npx robisie doctor --engine-config ./robisie.config.json` (także `--en
|
|
|
233
241
|
|
|
234
242
|
Kod 0 oznacza poprawną strukturę konfiguracji i dokładnie cztery kompletne przypisania wykonania; raport pokazuje rolę → imię / dostawcę / model / wysiłek. Kod 1 wskazuje plik, błędne pole (jeśli dotyczy) i następny krok. Ten tryb działa offline, bez klucza, uruchamiania dostawców, wykonywania komend silnika ani zapisu plików. Raport jawnie stwierdza: „sprawdzono konfigurację; nie sprawdzono uruchomienia dostawców”. Zwykły `doctor` zachowuje dotychczasową diagnozę instalacji.
|
|
235
243
|
|
|
236
|
-
Silnik paczki — `dist/engine/tick.cjs` — jest odrębny od instalatora: `init`/`doctor`/`uninstall` go nie uruchamiają. Uruchamia go `npx robisie factory run --engine-config ./robisie.config.json` (flaga `--once` wykonuje jeden takt)
|
|
244
|
+
Silnik paczki — `dist/engine/tick.cjs` — jest odrębny od instalatora: `init`/`doctor`/`uninstall` go nie uruchamiają. Uruchamia go `npx robisie factory run --engine-config ./robisie.config.json` (flaga `--once` wykonuje jeden takt) na Linuxie dla klienta oraz na Linuxie lub macOS dla jawnego hosta Robisie, z Node.js 24+; starszy Node, np. 22, otrzymuje odmowę przed `init`, `doctor` i `factory run`, a pozostałe systemy otrzymują kod 2 i komunikat. Pełny opis pól konfiguracji: `node_modules/robisie/docs/ENGINE-CONFIG.md`. 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.
|
|
237
245
|
|
|
238
246
|
Modele i wysiłki to przykładowe, dosłowne etykiety, bez gwarancji dostępności lub obsługi przez CLI. `grok-cli`/`none` opisują obecny review-job; nie dowodzą sterowania modelem ani wysiłkiem Groka. Imię jest metadanymi rejestru; Execution v1 zachowuje `{contractVersion:1,provider,model,effort}`. Walidacja nie jest odbiorem wykonania karty, dostawców ani całego procesu pracy.
|
|
239
247
|
|
package/dist/cli.js
CHANGED
|
@@ -29,7 +29,7 @@ const HELP = `robisie ${PACKAGE_VERSION} — łączy Twojego agenta z tablicą r
|
|
|
29
29
|
npx robisie init klucze A (ROBISIE_KEY) i B (ROBISIE_REVIEW_KEY), osobne ukryte pytania + konfiguracja MCP + role klienta
|
|
30
30
|
npx robisie doctor sprawdza A i B, wersję kontraktu, role i politykę enforced projektu
|
|
31
31
|
npx robisie uninstall usuwa wpisy robisie i role; zachowuje kopie zapasowe
|
|
32
|
-
npx robisie factory run nadzoruje
|
|
32
|
+
npx robisie factory run nadzoruje takty (Linux/local klienta; Linux lub macOS jawnego hosta; Node.js >=24)
|
|
33
33
|
npx robisie usage --input ./usage.json
|
|
34
34
|
wykonuje jedno lokalne użycie na landed SHA i zapisuje zdarzenie JSON; nie ustawia done
|
|
35
35
|
npx robisie mcp <${HELPER_SERVERS.join("|")}>
|
|
@@ -37,7 +37,7 @@ const HELP = `robisie ${PACKAGE_VERSION} — łączy Twojego agenta z tablicą r
|
|
|
37
37
|
|
|
38
38
|
Opcje factory run:
|
|
39
39
|
--engine-config <path> plik konfiguracji; flaga wygrywa z ROBISIE_ENGINE_CONFIG
|
|
40
|
-
--engine-config=<path>
|
|
40
|
+
--engine-config=<path> klient: local i stan poza repo; host: mode:host, pr|delivered i istniejący stan
|
|
41
41
|
--interval <sekundy> przerwa po zakończeniu taktu: 1–86400, domyślnie 120; także --interval=120
|
|
42
42
|
--once jeden takt bez przerwy; wyklucza jawne --interval
|
|
43
43
|
Ctrl+C zatrzymuje nadzorcę i grupę taktu; odłączone joby mogą działać dalej.
|
package/dist/constants.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/** Package identity and the server contract it speaks. */
|
|
2
2
|
export declare const PACKAGE_NAME = "robisie";
|
|
3
|
-
export declare const PACKAGE_VERSION = "0.
|
|
3
|
+
export declare const PACKAGE_VERSION = "0.5.1";
|
|
4
4
|
/**
|
|
5
5
|
* MAJOR of the agent-API contract this package understands.
|
|
6
6
|
* PARITY: src/lib/mcp/contract-version.ts (AGENT_API_CONTRACT_VERSION) on the server.
|
package/dist/constants.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/** Package identity and the server contract it speaks. */
|
|
2
2
|
export const PACKAGE_NAME = "robisie";
|
|
3
|
-
export const PACKAGE_VERSION = "0.
|
|
3
|
+
export const PACKAGE_VERSION = "0.5.1"; // x-release-please-version
|
|
4
4
|
/**
|
|
5
5
|
* MAJOR of the agent-API contract this package understands.
|
|
6
6
|
* PARITY: src/lib/mcp/contract-version.ts (AGENT_API_CONTRACT_VERSION) on the server.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"schema":1,"sha":"
|
|
1
|
+
{"schema":1,"sha":"2f4a2623b4d3d94f3f8ad1c0664cb0a60bad8a2e","dirty":false}
|
|
@@ -1688,6 +1688,6 @@
|
|
|
1688
1688
|
"status": 0,
|
|
1689
1689
|
"signal": null,
|
|
1690
1690
|
"stdout": "v24.3.0\n",
|
|
1691
|
-
"stderr": "(node:
|
|
1691
|
+
"stderr": "(node:15688) ExperimentalWarning: SQLite is an experimental feature and might change at any time\n(Use `node --trace-warnings ...` to show where the warning was created)\n"
|
|
1692
1692
|
}
|
|
1693
1693
|
}
|
package/dist/engine/tick.cjs
CHANGED
|
@@ -37628,7 +37628,7 @@ var init_constants = __esm({
|
|
|
37628
37628
|
"packages/client/src/constants.ts"() {
|
|
37629
37629
|
"use strict";
|
|
37630
37630
|
PACKAGE_NAME = "robisie";
|
|
37631
|
-
PACKAGE_VERSION = "0.
|
|
37631
|
+
PACKAGE_VERSION = "0.5.1";
|
|
37632
37632
|
SUPPORTED_CONTRACT_MAJOR = 1;
|
|
37633
37633
|
DEFAULT_ORIGIN = "https://robisie.app";
|
|
37634
37634
|
MCP_SERVER_NAME = "robisie";
|
|
@@ -37827,12 +37827,31 @@ function parseReceiver(raw, requiredChecks, label2) {
|
|
|
37827
37827
|
if (!requiredChecks.includes(verifyCheck)) fail(label2, "engine.receiver.verifyCheck: musi nale\u017Ce\u0107 do engine.requiredChecks");
|
|
37828
37828
|
return { githubRepo, verifyCheck, deployWorkflow };
|
|
37829
37829
|
}
|
|
37830
|
+
function parseHostPaths(raw, mode, delivery, label2) {
|
|
37831
|
+
if (mode !== "host" || delivery !== "pr" && delivery !== "delivered") fail(label2, "engine.hostPaths: wymagany jawny mode:host i delivery:pr|delivered");
|
|
37832
|
+
function object7(raw2, field, keys2) {
|
|
37833
|
+
if (!raw2 || typeof raw2 !== "object" || Array.isArray(raw2)) fail(label2, `${field}: wymagany kompletny obiekt \u015Bcie\u017Cek`);
|
|
37834
|
+
const value2 = raw2;
|
|
37835
|
+
if (Object.keys(value2).some((key) => !keys2.includes(key))) fail(label2, `${field}: nieznane pole`);
|
|
37836
|
+
return value2;
|
|
37837
|
+
}
|
|
37838
|
+
const value = object7(raw, "engine.hostPaths", ["hostStateDir", "inputsDir", "fjConfigPath", "siewca"]);
|
|
37839
|
+
const siewca = object7(value.siewca, "engine.hostPaths.siewca", ["stateDir", "wsadyDir", "bellPath"]);
|
|
37840
|
+
const path34 = (value2, field) => (0, import_node_path2.resolve)((0, import_node_path2.dirname)(label2), text2(value2, `engine.hostPaths.${field}`, label2));
|
|
37841
|
+
return {
|
|
37842
|
+
hostStateDir: path34(value.hostStateDir, "hostStateDir"),
|
|
37843
|
+
inputsDir: path34(value.inputsDir, "inputsDir"),
|
|
37844
|
+
fjConfigPath: path34(value.fjConfigPath, "fjConfigPath"),
|
|
37845
|
+
siewca: { stateDir: path34(siewca.stateDir, "siewca.stateDir"), wsadyDir: path34(siewca.wsadyDir, "siewca.wsadyDir"), bellPath: path34(siewca.bellPath, "siewca.bellPath") }
|
|
37846
|
+
};
|
|
37847
|
+
}
|
|
37830
37848
|
function parseEngineConfig(raw, configPath) {
|
|
37831
37849
|
const config2 = parseConfig(raw, (0, import_node_path2.resolve)(configPath));
|
|
37832
37850
|
const label2 = config2.configPath;
|
|
37833
37851
|
const engine = raw.engine;
|
|
37834
37852
|
if (!engine || typeof engine !== "object" || Array.isArray(engine)) fail(label2, "engine: wymagany obiekt");
|
|
37835
37853
|
const value = engine;
|
|
37854
|
+
if (value.mode !== void 0 && value.mode !== "client" && value.mode !== "host") fail(label2, "engine.mode: gdy podane \u2014 client|host");
|
|
37836
37855
|
const repo = (0, import_node_path2.resolve)((0, import_node_path2.dirname)(label2), text2(value.repo, "engine.repo", label2));
|
|
37837
37856
|
const branch = text2(value.branch, "engine.branch", label2);
|
|
37838
37857
|
if (!value.commands || typeof value.commands !== "object" || Array.isArray(value.commands)) fail(label2, "engine.commands: wymagany obiekt {test, lint, build}");
|
|
@@ -37848,6 +37867,8 @@ function parseEngineConfig(raw, configPath) {
|
|
|
37848
37867
|
commands: { test, lint, build },
|
|
37849
37868
|
requiredChecks,
|
|
37850
37869
|
delivery: value.delivery,
|
|
37870
|
+
...value.mode !== void 0 ? { mode: value.mode } : {},
|
|
37871
|
+
...Object.hasOwn(value, "hostPaths") ? { hostPaths: parseHostPaths(value.hostPaths, value.mode, value.delivery, label2) } : {},
|
|
37851
37872
|
...Object.hasOwn(value, "receiver") ? { receiver: parseReceiver(value.receiver, requiredChecks, label2) } : {}
|
|
37852
37873
|
} };
|
|
37853
37874
|
}
|
|
@@ -53418,7 +53439,7 @@ function finishTickState(state, outcome, tick, at3, facts = {}) {
|
|
|
53418
53439
|
function readLoadedSha(repo, git2 = quietGit) {
|
|
53419
53440
|
try {
|
|
53420
53441
|
if (isStandaloneFile(__filename)) {
|
|
53421
|
-
const id2 = record6(JSON.parse((0, import_node_fs11.readFileSync)(import_node_path13.default.join(
|
|
53442
|
+
const id2 = record6(JSON.parse((0, import_node_fs11.readFileSync)(import_node_path13.default.join(ENGINE_CODE_REPO, "engine", "build-id.json"), "utf8")));
|
|
53422
53443
|
return id2.schema === 1 && typeof id2.sha === "string" && /^[a-f0-9]{40}$/.test(id2.sha) && typeof id2.dirty === "boolean" ? `${id2.sha}${id2.dirty ? "+dirty" : ""}` : "UNKNOWN";
|
|
53423
53444
|
}
|
|
53424
53445
|
const head = git2(["rev-parse", "HEAD"], repo);
|
|
@@ -53776,6 +53797,26 @@ function smokeCandidate(target, _head, repo, stateDir, timeoutMs) {
|
|
|
53776
53797
|
if (!(0, import_node_fs11.existsSync)(modules)) (0, import_node_fs11.symlinkSync)(import_node_path13.default.join(repo, "node_modules"), modules);
|
|
53777
53798
|
const scratch = import_node_path13.default.join(stateDir, "smoke", target.slice(0, 8));
|
|
53778
53799
|
(0, import_node_fs11.mkdirSync)(scratch, { recursive: true });
|
|
53800
|
+
const smokeEnv = { ...process.env };
|
|
53801
|
+
delete smokeEnv.MASZYNISTA_ZASIEW_LIVE;
|
|
53802
|
+
smokeEnv.ZASIEW_AUTO_STATE = import_node_path13.default.join(scratch, "zasiew-auto");
|
|
53803
|
+
smokeEnv.ZASIEW_AUTO_WSADY = import_node_path13.default.join(scratch, "zasiew-wsady");
|
|
53804
|
+
smokeEnv.MASZYNISTA_ZASIEW_BELL = import_node_path13.default.join(scratch, "zasiew.bell");
|
|
53805
|
+
if (smokeEnv.ROBISIE_ENGINE_CONFIG) {
|
|
53806
|
+
const installation = currentEngine(), config2 = loadEngineConfig(smokeEnv.ROBISIE_ENGINE_CONFIG);
|
|
53807
|
+
const inputs = import_node_path13.default.join(scratch, "inputs");
|
|
53808
|
+
(0, import_node_fs11.mkdirSync)(inputs, { recursive: true });
|
|
53809
|
+
for (const file3 of ["NORTH-STAR.md", "AUTHORITY.md"])
|
|
53810
|
+
(0, import_node_fs11.writeFileSync)(import_node_path13.default.join(inputs, file3), (0, import_node_fs11.readFileSync)(import_node_path13.default.join(installation.inputsDir, file3)));
|
|
53811
|
+
const smokeConfig = import_node_path13.default.join(scratch, "robisie.config.json");
|
|
53812
|
+
(0, import_node_fs11.writeFileSync)(smokeConfig, JSON.stringify({
|
|
53813
|
+
...config2,
|
|
53814
|
+
configPath: void 0,
|
|
53815
|
+
stateDir: scratch,
|
|
53816
|
+
engine: { ...config2.engine, repo: root, hostPaths: void 0 }
|
|
53817
|
+
}));
|
|
53818
|
+
smokeEnv.ROBISIE_ENGINE_CONFIG = smokeConfig;
|
|
53819
|
+
}
|
|
53779
53820
|
if (Date.now() >= deadline) return { rc: 124, timedOut: true, output: "smoke timeout podczas przygotowania" };
|
|
53780
53821
|
const childLimit = remaining();
|
|
53781
53822
|
(0, import_node_fs11.writeFileSync)(claim, JSON.stringify({ pid: null }), { flag: "wx" });
|
|
@@ -53787,11 +53828,12 @@ function smokeCandidate(target, _head, repo, stateDir, timeoutMs) {
|
|
|
53787
53828
|
timeout: childLimit,
|
|
53788
53829
|
maxBuffer: 20 * 1024 * 1024,
|
|
53789
53830
|
env: {
|
|
53790
|
-
...
|
|
53831
|
+
...smokeEnv,
|
|
53791
53832
|
MASZYNISTA_DIR: scratch,
|
|
53792
53833
|
MASZYNISTA_HOST_STATE_DIR: scratch,
|
|
53793
53834
|
MASZYNISTA_SMOKE: "1",
|
|
53794
53835
|
MASZYNISTA_SMOKE_TIMEOUT_MS: String(childLimit),
|
|
53836
|
+
ROBISIE_EGRESS_COUNTER_FILE: import_node_path13.default.join(scratch, "egress-bytes.jsonl"),
|
|
53795
53837
|
ZASIEW_CARDS_ROOT: process.env.ZASIEW_CARDS_ROOT ?? import_node_path13.default.resolve(repo, "../../Robisie Control Room/Notes/cards")
|
|
53796
53838
|
}
|
|
53797
53839
|
};
|
|
@@ -53925,6 +53967,12 @@ async function runHostActivation(input, deps = {}) {
|
|
|
53925
53967
|
if (recovery !== "previous") return { code: recovery === "pending" ? "skip pending" : "hold recovery", target: intentTarget, detail: "owner=CEO; rozliczenie zamiaru przed nast\u0119pnym FF" };
|
|
53926
53968
|
pinned = state.intent.target;
|
|
53927
53969
|
}
|
|
53970
|
+
if (!pinned && isStandaloneFile(__filename)) {
|
|
53971
|
+
const loaded = readLoadedSha(ENGINE_CODE_REPO);
|
|
53972
|
+
if (!/^[a-f0-9]{40}$/.test(loaded))
|
|
53973
|
+
return { code: "hold package target", detail: "paczka bez czystego pe\u0142nego SHA; sprawd\u017A w\u0142asny build-id.json artefaktu" };
|
|
53974
|
+
pinned = loaded;
|
|
53975
|
+
}
|
|
53928
53976
|
if (state.confirmed && input.tick >= state.confirmed.tick && input.tick - state.confirmed.tick < BREAKER_WINDOW_TICKS)
|
|
53929
53977
|
return { code: "skip breaker window", target: state.confirmed.target };
|
|
53930
53978
|
if (!deps.infrastructureChecks || !deps.infrastructurePullRequest) {
|
|
@@ -53942,6 +53990,14 @@ async function runHostActivation(input, deps = {}) {
|
|
|
53942
53990
|
}
|
|
53943
53991
|
}
|
|
53944
53992
|
const commits = git2(["rev-list", "--first-parent", `${head}..origin/main`], input.repo).split("\n").filter(Boolean);
|
|
53993
|
+
if (pinned && !state.intent && isStandaloneFile(__filename)) {
|
|
53994
|
+
if (head === pinned) return endRefusal({ code: "skip package current", target: pinned, detail: "\u017Ar\xF3d\u0142a ju\u017C na SHA zainstalowanej paczki" });
|
|
53995
|
+
if (!commits.includes(pinned) || !isAncestor(git2, head, pinned, input.repo)) return {
|
|
53996
|
+
code: "hold package target",
|
|
53997
|
+
target: pinned,
|
|
53998
|
+
detail: "SHA paczki poza kandydatami zdalnej bazy lub HEAD nie jest jego przodkiem; owner=CEO; bez cofania lub zmiany historii \u017Ar\xF3de\u0142"
|
|
53999
|
+
};
|
|
54000
|
+
}
|
|
53945
54001
|
let target;
|
|
53946
54002
|
let refusal;
|
|
53947
54003
|
for (const sha5 of commits) {
|
|
@@ -54172,6 +54228,8 @@ var init_host_activation = __esm({
|
|
|
54172
54228
|
init_lib();
|
|
54173
54229
|
init_service_reload();
|
|
54174
54230
|
init_engine_standalone();
|
|
54231
|
+
init_engine_consumer();
|
|
54232
|
+
init_engine_config();
|
|
54175
54233
|
STATE_FILE = "host-activation.json";
|
|
54176
54234
|
MODE_FILE = "HOST-ACTIVATION.mode";
|
|
54177
54235
|
BREAKER_WINDOW_TICKS = 3;
|
|
@@ -55128,6 +55186,7 @@ function defaults2(env) {
|
|
|
55128
55186
|
source: "defaults",
|
|
55129
55187
|
configPath: null,
|
|
55130
55188
|
repo: import_node_path15.default.resolve(MASZYNISTA_DIR, ".."),
|
|
55189
|
+
resourcesRepo: import_node_path15.default.resolve(MASZYNISTA_DIR, ".."),
|
|
55131
55190
|
remote: REMOTE,
|
|
55132
55191
|
branch: BRANCH,
|
|
55133
55192
|
baseRef: `${REMOTE}/${BRANCH}`,
|
|
@@ -55169,22 +55228,23 @@ function readJson(file3, origin) {
|
|
|
55169
55228
|
function fromFile(file3, origin) {
|
|
55170
55229
|
const { raw, configPath } = readJson(file3, origin);
|
|
55171
55230
|
const config2 = parseEngineConfig(raw, configPath);
|
|
55172
|
-
const mode = raw.engine.mode;
|
|
55173
|
-
if (mode !== void 0 && mode !== "client" && mode !== "host") throw new Error(`${configPath}: engine.mode: gdy podane \u2014 client|host`);
|
|
55174
55231
|
const { engine } = config2;
|
|
55232
|
+
const mode = engine.mode;
|
|
55233
|
+
const client = mode === "client" || engine.delivery === "local";
|
|
55175
55234
|
if (engine.receiver) {
|
|
55176
55235
|
if (mode !== "host" || engine.delivery === "local") throw new Error(`${configPath}: engine.receiver: wymagany jawny mode:host i delivery:pr|delivered`);
|
|
55177
55236
|
if (engine.branch !== BRANCH || Object.keys(RECEIVER).some((key) => engine.receiver[key] !== RECEIVER[key]))
|
|
55178
55237
|
throw new Error(`${configPath}: engine.receiver: nieobs\u0142ugiwany odbiorca lub ga\u0142\u0105\u017A hosta`);
|
|
55179
55238
|
}
|
|
55180
|
-
const hostStateDir2 = import_node_path15.default.join(config2.stateDir, "host");
|
|
55239
|
+
const hostStateDir2 = engine.hostPaths?.hostStateDir ?? import_node_path15.default.join(config2.stateDir, "host");
|
|
55181
55240
|
return {
|
|
55182
55241
|
source: "file",
|
|
55183
55242
|
configPath,
|
|
55184
55243
|
repo: engine.repo,
|
|
55244
|
+
resourcesRepo: mode === "host" && !client ? engine.repo : import_node_path15.default.resolve(MASZYNISTA_DIR, ".."),
|
|
55185
55245
|
remote: REMOTE,
|
|
55186
55246
|
branch: engine.branch,
|
|
55187
|
-
baseRef:
|
|
55247
|
+
baseRef: client ? `refs/heads/${engine.branch}` : `${REMOTE}/${engine.branch}`,
|
|
55188
55248
|
project: { kind: "id", value: config2.project },
|
|
55189
55249
|
tracks: config2.tracks.map((track) => ({ ...track })),
|
|
55190
55250
|
defaultTrackLabel: DEFAULT_TRACK_LABEL,
|
|
@@ -55195,14 +55255,14 @@ function fromFile(file3, origin) {
|
|
|
55195
55255
|
stateDir: config2.stateDir,
|
|
55196
55256
|
hostStateDir: hostStateDir2,
|
|
55197
55257
|
receiverHostStateDir: hostStateDir2,
|
|
55198
|
-
siewca: {
|
|
55258
|
+
siewca: engine.hostPaths?.siewca ?? {
|
|
55199
55259
|
stateDir: import_node_path15.default.join(config2.stateDir, "siewca"),
|
|
55200
55260
|
wsadyDir: import_node_path15.default.join(config2.stateDir, "siewca", "wsady"),
|
|
55201
55261
|
bellPath: import_node_path15.default.join(config2.stateDir, "siewca", "zasiew.bell")
|
|
55202
55262
|
},
|
|
55203
|
-
fjConfigPath: import_node_path15.default.join(config2.stateDir, "factory-judgment.json"),
|
|
55204
|
-
inputsDir: import_node_path15.default.join(config2.stateDir, "inputs"),
|
|
55205
|
-
client
|
|
55263
|
+
fjConfigPath: engine.hostPaths?.fjConfigPath ?? import_node_path15.default.join(config2.stateDir, "factory-judgment.json"),
|
|
55264
|
+
inputsDir: engine.hostPaths?.inputsDir ?? import_node_path15.default.join(config2.stateDir, "inputs"),
|
|
55265
|
+
client
|
|
55206
55266
|
};
|
|
55207
55267
|
}
|
|
55208
55268
|
function resolveEngine(input) {
|
|
@@ -55294,6 +55354,7 @@ __export2(engine_consumer_exports, {
|
|
|
55294
55354
|
engineRemote: () => engineRemote,
|
|
55295
55355
|
engineRemoteBranchRef: () => engineRemoteBranchRef,
|
|
55296
55356
|
engineRequiredChecks: () => engineRequiredChecks,
|
|
55357
|
+
engineResourcesRepo: () => engineResourcesRepo,
|
|
55297
55358
|
engineShellLines: () => engineShellLines,
|
|
55298
55359
|
engineSiewca: () => engineSiewca,
|
|
55299
55360
|
engineStateDir: () => engineStateDir,
|
|
@@ -55317,7 +55378,7 @@ function engineShellLines(what, env = process.env) {
|
|
|
55317
55378
|
if (lines2.some((line2) => !line2 || /[\r\n]/.test(line2))) throw new Error("engine-consumer: \u015Bcie\u017Cka Siewcy pusta albo z now\u0105 lini\u0105");
|
|
55318
55379
|
return lines2;
|
|
55319
55380
|
}
|
|
55320
|
-
var import_node_path17, ENGINE_CODE_REPO, fileCache, engineRemote, engineBranch, engineBaseRef, engineBranchRef, engineRemoteBranchRef, engineRequiredChecks, engineReceiver, engineProject, engineTracks, engineDefaultTrackLabel, engineTaskRepo, engineStateDir, engineHostStateDir, engineReceiverHostStateDir, engineSiewca, engineFjConfigPath, engineInputsDir, engineClient;
|
|
55381
|
+
var import_node_path17, ENGINE_CODE_REPO, fileCache, engineRemote, engineBranch, engineBaseRef, engineBranchRef, engineRemoteBranchRef, engineRequiredChecks, engineReceiver, engineProject, engineTracks, engineDefaultTrackLabel, engineTaskRepo, engineResourcesRepo, engineStateDir, engineHostStateDir, engineReceiverHostStateDir, engineSiewca, engineFjConfigPath, engineInputsDir, engineClient;
|
|
55321
55382
|
var init_engine_consumer = __esm({
|
|
55322
55383
|
"maszynista/engine-consumer.ts"() {
|
|
55323
55384
|
"use strict";
|
|
@@ -55344,6 +55405,7 @@ var init_engine_consumer = __esm({
|
|
|
55344
55405
|
engineTracks = (env) => currentEngine(env).tracks;
|
|
55345
55406
|
engineDefaultTrackLabel = (env) => currentEngine(env).defaultTrackLabel;
|
|
55346
55407
|
engineTaskRepo = (env) => currentEngine(env).repo;
|
|
55408
|
+
engineResourcesRepo = (env) => currentEngine(env).resourcesRepo;
|
|
55347
55409
|
engineStateDir = (env) => currentEngine(env).stateDir;
|
|
55348
55410
|
engineHostStateDir = (env) => currentEngine(env).hostStateDir;
|
|
55349
55411
|
engineReceiverHostStateDir = (env) => currentEngine(env).receiverHostStateDir;
|
|
@@ -55420,7 +55482,7 @@ var init_env = __esm({
|
|
|
55420
55482
|
import_node_child_process6 = require("node:child_process");
|
|
55421
55483
|
import_node_path18 = __toESM(require("node:path"));
|
|
55422
55484
|
init_engine_consumer();
|
|
55423
|
-
REPO =
|
|
55485
|
+
REPO = engineResourcesRepo();
|
|
55424
55486
|
DIR = engineStateDir();
|
|
55425
55487
|
}
|
|
55426
55488
|
});
|
package/dist/engine-config.d.ts
CHANGED
|
@@ -40,9 +40,22 @@ export interface InstanceConfig {
|
|
|
40
40
|
/** Plik konfiguracji, z którego wczytano ustawienia (bezwzględny). */
|
|
41
41
|
configPath: string;
|
|
42
42
|
}
|
|
43
|
+
/** Istniejące miejsca jawnego hosta; parser nie sprawdza ich zawartości ani nie tworzy katalogów. */
|
|
44
|
+
export interface EngineHostPaths {
|
|
45
|
+
hostStateDir: string;
|
|
46
|
+
inputsDir: string;
|
|
47
|
+
fjConfigPath: string;
|
|
48
|
+
siewca: {
|
|
49
|
+
stateDir: string;
|
|
50
|
+
wsadyDir: string;
|
|
51
|
+
bellPath: string;
|
|
52
|
+
};
|
|
53
|
+
}
|
|
43
54
|
/** K2: dane silnika w tym samym pliku co K4; parsowanie niczego nie uruchamia. */
|
|
44
55
|
export interface EngineConfig extends InstanceConfig {
|
|
45
56
|
engine: {
|
|
57
|
+
/** Jawny tryb instalacji; brak zachowuje dotychczasowe rozpoznanie przez delivery. */
|
|
58
|
+
mode?: 'host' | 'client';
|
|
46
59
|
/** Repo docelowe (bezwzględne); ścieżka wejściowa względem pliku konfiguracji. */
|
|
47
60
|
repo: string;
|
|
48
61
|
/** Główna gałąź repo docelowego. */
|
|
@@ -63,6 +76,8 @@ export interface EngineConfig extends InstanceConfig {
|
|
|
63
76
|
verifyCheck: string;
|
|
64
77
|
deployWorkflow: string;
|
|
65
78
|
};
|
|
79
|
+
/** Kompletny blok sześciu ścieżek, wyłącznie dla jawnego hosta z delivery pr|delivered. */
|
|
80
|
+
hostPaths?: EngineHostPaths;
|
|
66
81
|
};
|
|
67
82
|
}
|
|
68
83
|
export declare const CONFIG_FILE = "robisie.config.json";
|
package/dist/engine-config.js
CHANGED
|
@@ -133,6 +133,27 @@ function parseReceiver(raw, requiredChecks, label) {
|
|
|
133
133
|
fail(label, 'engine.receiver.verifyCheck: musi należeć do engine.requiredChecks');
|
|
134
134
|
return { githubRepo, verifyCheck, deployWorkflow };
|
|
135
135
|
}
|
|
136
|
+
function parseHostPaths(raw, mode, delivery, label) {
|
|
137
|
+
if (mode !== 'host' || (delivery !== 'pr' && delivery !== 'delivered'))
|
|
138
|
+
fail(label, 'engine.hostPaths: wymagany jawny mode:host i delivery:pr|delivered');
|
|
139
|
+
function object(raw, field, keys) {
|
|
140
|
+
if (!raw || typeof raw !== 'object' || Array.isArray(raw))
|
|
141
|
+
fail(label, `${field}: wymagany kompletny obiekt ścieżek`);
|
|
142
|
+
const value = raw;
|
|
143
|
+
if (Object.keys(value).some(key => !keys.includes(key)))
|
|
144
|
+
fail(label, `${field}: nieznane pole`);
|
|
145
|
+
return value;
|
|
146
|
+
}
|
|
147
|
+
const value = object(raw, 'engine.hostPaths', ['hostStateDir', 'inputsDir', 'fjConfigPath', 'siewca']);
|
|
148
|
+
const siewca = object(value.siewca, 'engine.hostPaths.siewca', ['stateDir', 'wsadyDir', 'bellPath']);
|
|
149
|
+
const path = (value, field) => resolve(dirname(label), text(value, `engine.hostPaths.${field}`, label));
|
|
150
|
+
return {
|
|
151
|
+
hostStateDir: path(value.hostStateDir, 'hostStateDir'),
|
|
152
|
+
inputsDir: path(value.inputsDir, 'inputsDir'),
|
|
153
|
+
fjConfigPath: path(value.fjConfigPath, 'fjConfigPath'),
|
|
154
|
+
siewca: { stateDir: path(siewca.stateDir, 'siewca.stateDir'), wsadyDir: path(siewca.wsadyDir, 'siewca.wsadyDir'), bellPath: path(siewca.bellPath, 'siewca.bellPath') },
|
|
155
|
+
};
|
|
156
|
+
}
|
|
136
157
|
export function parseEngineConfig(raw, configPath) {
|
|
137
158
|
const config = parseConfig(raw, resolve(configPath));
|
|
138
159
|
const label = config.configPath;
|
|
@@ -140,6 +161,8 @@ export function parseEngineConfig(raw, configPath) {
|
|
|
140
161
|
if (!engine || typeof engine !== 'object' || Array.isArray(engine))
|
|
141
162
|
fail(label, 'engine: wymagany obiekt');
|
|
142
163
|
const value = engine;
|
|
164
|
+
if (value.mode !== undefined && value.mode !== 'client' && value.mode !== 'host')
|
|
165
|
+
fail(label, 'engine.mode: gdy podane — client|host');
|
|
143
166
|
const repo = resolve(dirname(label), text(value.repo, 'engine.repo', label));
|
|
144
167
|
const branch = text(value.branch, 'engine.branch', label);
|
|
145
168
|
if (!value.commands || typeof value.commands !== 'object' || Array.isArray(value.commands))
|
|
@@ -152,6 +175,8 @@ export function parseEngineConfig(raw, configPath) {
|
|
|
152
175
|
if (value.delivery !== 'delivered' && value.delivery !== 'pr' && value.delivery !== 'local')
|
|
153
176
|
fail(label, 'engine.delivery: wymagane delivered|pr|local');
|
|
154
177
|
return { ...config, engine: { repo, branch, commands: { test, lint, build }, requiredChecks, delivery: value.delivery,
|
|
178
|
+
...(value.mode !== undefined ? { mode: value.mode } : {}),
|
|
179
|
+
...(Object.hasOwn(value, 'hostPaths') ? { hostPaths: parseHostPaths(value.hostPaths, value.mode, value.delivery, label) } : {}),
|
|
155
180
|
...(Object.hasOwn(value, 'receiver') ? { receiver: parseReceiver(value.receiver, requiredChecks, label) } : {}) } };
|
|
156
181
|
}
|
|
157
182
|
export function loadEngineConfig(path) {
|
package/dist/factory-run.js
CHANGED
|
@@ -105,8 +105,8 @@ export async function runFactory(ctx, options, overrides = {}) {
|
|
|
105
105
|
runtime.signals.on("SIGINT", interrupt);
|
|
106
106
|
runtime.signals.on("SIGTERM", terminate);
|
|
107
107
|
try {
|
|
108
|
-
if (
|
|
109
|
-
fail(2, "Factory run wymaga
|
|
108
|
+
if (Number(runtime.nodeVersion.split(".")[0]) < 24) {
|
|
109
|
+
fail(2, "Factory run wymaga Node.js >=24.", "Uruchom polecenie z Node.js 24 lub nowszym.");
|
|
110
110
|
}
|
|
111
111
|
const selected = options.engineConfig ?? ctx.env.ROBISIE_ENGINE_CONFIG;
|
|
112
112
|
const configStep = "Popraw konfigurację i sprawdź ją poleceniem `npx robisie doctor --engine-config <path>`, podstawiając ścieżkę pliku; następnie ponów factory run.";
|
|
@@ -122,8 +122,13 @@ export async function runFactory(ctx, options, overrides = {}) {
|
|
|
122
122
|
catch {
|
|
123
123
|
fail(78, "Nie można wczytać konfiguracji silnika.", configStep);
|
|
124
124
|
}
|
|
125
|
-
|
|
126
|
-
|
|
125
|
+
const host = config.engine.mode === "host";
|
|
126
|
+
if (ctx.platform !== "linux" && !(ctx.platform === "darwin" && host))
|
|
127
|
+
fail(2, "Factory run wymaga Linuxa; macOS jest dostępny dla jawnego hosta.", configStep);
|
|
128
|
+
if (host ? config.engine.delivery === "local" : config.engine.delivery !== "local")
|
|
129
|
+
fail(78, "Factory run wymaga delivery: pr|delivered dla hosta albo local dla klienta.", configStep);
|
|
130
|
+
if (host && ctx.env.MASZYNISTA_PLANNER_TRANSPORT !== undefined && ctx.env.MASZYNISTA_PLANNER_TRANSPORT !== "db")
|
|
131
|
+
fail(78, "Host factory run wymaga transportu db.", "Usuń jawny transport api lub ustaw MASZYNISTA_PLANNER_TRANSPORT=db i ponów polecenie.");
|
|
127
132
|
let repo;
|
|
128
133
|
let state;
|
|
129
134
|
try {
|
|
@@ -131,23 +136,25 @@ export async function runFactory(ctx, options, overrides = {}) {
|
|
|
131
136
|
if (!statSync(repo).isDirectory())
|
|
132
137
|
throw new Error("repo is not a directory");
|
|
133
138
|
state = physical(config.stateDir);
|
|
134
|
-
if (within(repo, state))
|
|
135
|
-
throw new Error("state
|
|
139
|
+
if (host ? !statSync(state).isDirectory() : within(repo, state))
|
|
140
|
+
throw new Error("invalid state directory");
|
|
136
141
|
}
|
|
137
142
|
catch {
|
|
138
|
-
fail(78, "Nie można potwierdzić repo i katalogu stanu poza repozytorium.", configStep);
|
|
143
|
+
fail(78, "Nie można potwierdzić repo i katalogu stanu (host: istniejący katalog; klient: poza repozytorium).", configStep);
|
|
139
144
|
}
|
|
140
145
|
const bundle = fileURLToPath(new URL("./engine/tick.cjs", runtime.moduleUrl));
|
|
141
146
|
if (!optionalFile(bundle))
|
|
142
147
|
fail(2, "Nie znaleziono silnika w zainstalowanej paczce.", "Zainstaluj kompletną paczkę robisie i ponów polecenie.");
|
|
143
|
-
const env = {};
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
148
|
+
const env = (host ? { ...ctx.env } : {});
|
|
149
|
+
if (!host)
|
|
150
|
+
for (const name of ENV_NAMES)
|
|
151
|
+
if (ctx.env[name] !== undefined)
|
|
152
|
+
env[name] = ctx.env[name];
|
|
147
153
|
env.ROBISIE_ENGINE_CONFIG = config.configPath;
|
|
148
|
-
|
|
154
|
+
if (!host)
|
|
155
|
+
env.MASZYNISTA_PLANNER_TRANSPORT = "api";
|
|
149
156
|
const helper = fileURLToPath(new URL("./k3-helper-cli.js", runtime.moduleUrl));
|
|
150
|
-
if (env.ROBISIE_CODEX_HELPER === undefined && optionalFile(helper))
|
|
157
|
+
if (!host && env.ROBISIE_CODEX_HELPER === undefined && optionalFile(helper))
|
|
151
158
|
env.ROBISIE_CODEX_HELPER = helper;
|
|
152
159
|
const checkInstallation = () => {
|
|
153
160
|
try {
|
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.
|
|
20
|
+
export declare const MANAGED_LINE = "<!-- robisie:managed 0.5.1 \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/ENGINE-CONFIG.md
CHANGED
|
@@ -35,6 +35,61 @@ Nie wpisuj sekretów do argv — argumenty mogą trafić do listy procesów lub
|
|
|
35
35
|
narzędzi wykonujących komendy.
|
|
36
36
|
`delivery: "pr"` opisuje sposób dostarczenia; sam odczyt nie tworzy PR.
|
|
37
37
|
|
|
38
|
+
`engine.mode` jest opcjonalne: `host` albo `client`; inne wartości są błędem.
|
|
39
|
+
`factory run` wymaga Node.js >=24. Klient korzysta z Linuxa, dostawy `local`,
|
|
40
|
+
stanu poza repo i filtrowanego środowiska z transportem API.
|
|
41
|
+
Jawny host Robisie (`mode: "host"`, `pr|delivered`) działa na Linuxie i macOS,
|
|
42
|
+
z istniejącym stanem (także w repo) i transportem DB. Jawne `api` lub nieznany
|
|
43
|
+
transport w środowisku hosta powoduje odmowę. Host zachowuje środowisko operatora,
|
|
44
|
+
odczyt `.env`/Keychain i pierwszeństwo własnego helpera; nie otrzymuje fallbacku
|
|
45
|
+
helpera klienta. Te ustawienia nie rozszerzają środowiska Workera ani recenzenta.
|
|
46
|
+
|
|
47
|
+
Dla jawnego hosta `engine.repo` jest także checkoutem zasobów i źródłowych dzieci:
|
|
48
|
+
selektora i FJ. Tożsamość wykonywanego bundla pochodzi z jego własnego
|
|
49
|
+
`engine/build-id.json`, niezależnie od HEAD i ewentualnego znaczka w checkoutcie.
|
|
50
|
+
Aktywator wybiera wyłącznie dokładny czysty SHA paczki (pierwszeństwo zachowuje
|
|
51
|
+
istniejący intent), po dotychczasowych bramkach PR/CI/smoke/FF. Cel poza kandydatami
|
|
52
|
+
`HEAD..origin/main` oznacza jawny HOLD; HEAD na celu oznacza pominięcie FF,
|
|
53
|
+
bez automatycznego wytwarzania confirmed. Bez konfiguracji host działa jak dotąd.
|
|
54
|
+
|
|
55
|
+
Opcjonalny `engine.hostPaths` zachowuje istniejące miejsca hosta. Blok jest
|
|
56
|
+
kompletny: `hostStateDir`, `inputsDir`, `fjConfigPath` oraz
|
|
57
|
+
`siewca.stateDir`, `siewca.wsadyDir`, `siewca.bellPath`. Jest dozwolony wyłącznie
|
|
58
|
+
przy jawnym `mode: "host"` i `delivery: "pr"` lub `"delivered"`. Brak pola,
|
|
59
|
+
obce pole na dowolnym poziomie bloku, pusty/niestringowy path lub niewłaściwy tryb
|
|
60
|
+
powodują błąd ze wskazaniem pola. Ścieżki względne liczone są od katalogu
|
|
61
|
+
kanonicznego (realpath) pliku konfiguracji, także przy wczytaniu przez dowiązanie.
|
|
62
|
+
Parser nie czyta zawartości tych miejsc, nie tworzy katalogów i nie migruje danych.
|
|
63
|
+
`hostStateDir` zasila oba miejsca resolvera: `hostStateDir` i `receiverHostStateDir`.
|
|
64
|
+
|
|
65
|
+
Bez bloku zachowany jest układ 0.4.6: host-state to `<stateDir>/host`, wejścia ról
|
|
66
|
+
`<stateDir>/inputs`, FJ `<stateDir>/factory-judgment.json`, a Siewca
|
|
67
|
+
`<stateDir>/siewca/{,wsady,zasiew.bell}`. Host bez pliku konfiguracji zachowuje
|
|
68
|
+
swoje dotychczasowe domyślne ścieżki i zmienne środowiska.
|
|
69
|
+
Przed przełączeniem porównaj wszystkie fizyczne ścieżki z działającym hostem;
|
|
70
|
+
samo `stateDir` ani poprawna składnia konfiguracji nie dowodzą zgodności.
|
|
71
|
+
|
|
72
|
+
Przykład **zmierzonych ścieżek hosta ROBISIE** (11.11.2026), bez sekretów.
|
|
73
|
+
W pełnym configu hosta ustaw `engine.repo` na
|
|
74
|
+
`/Users/admin/Documents/PersonalHQ/Projects/Robisie/app`, a główne `stateDir` na
|
|
75
|
+
`/Users/admin/Documents/PersonalHQ/Projects/Robisie/app/maszynista` i dodaj do `engine`:
|
|
76
|
+
|
|
77
|
+
```json
|
|
78
|
+
"hostPaths": {
|
|
79
|
+
"hostStateDir": "/Users/admin/.robisie/maszynista",
|
|
80
|
+
"inputsDir": "/Users/admin/Documents/PersonalHQ/Projects/Robisie/app/maszynista",
|
|
81
|
+
"fjConfigPath": "/Users/admin/.robisie/maszynista/factory-judgment.json",
|
|
82
|
+
"siewca": {
|
|
83
|
+
"stateDir": "/Users/admin/Documents/PersonalHQ/Projects/Robisie/_reksio/notes/zasiew-auto",
|
|
84
|
+
"wsadyDir": "/Users/admin/Documents/PersonalHQ/Projects/Robisie/_reksio/notes/zasiew-wsady",
|
|
85
|
+
"bellPath": "/Users/admin/.robisie/zasiew.bell"
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Pełny wzorzec configu hosta i walidacja przed podmianą plista:
|
|
91
|
+
[runbook CTO](https://github.com/chuppa12/robisie-app/blob/main/docs/runbooks/host-package.md).
|
|
92
|
+
|
|
38
93
|
Role silnika to `coordinator`, `owner`, `planner`, `advisor`.
|
|
39
94
|
`forms` zawierają dosłowne formy z uwzględnieniem wielkości liter, a
|
|
40
95
|
`owner.genitive` służy m.in. do zapisu „Efekt dla Ali”. To osobne ustawienia
|
package/docs/README.en.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# robisie — from account to accepted card (package 0.
|
|
1
|
+
# robisie — from account to accepted card (package 0.5.1) <!-- 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
|
|
|
@@ -17,7 +17,7 @@ If the registry README is empty, use the guides shipped locally at `node_modules
|
|
|
17
17
|
<a id="wymagania"></a>
|
|
18
18
|
## Requirements
|
|
19
19
|
|
|
20
|
-
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
|
|
20
|
+
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`) for the client requires Linux; an explicit Robisie host (`engine.mode: "host"`, delivery `pr|delivered`) also supports macOS. It 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.
|
|
21
21
|
|
|
22
22
|
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.
|
|
23
23
|
|
|
@@ -38,7 +38,7 @@ Project lookup is the authenticated read of active projects through `list_projec
|
|
|
38
38
|
<!-- agent-consent:start -->
|
|
39
39
|
### Agent instructions — one authorization for the flow
|
|
40
40
|
|
|
41
|
-
At the start, ask once for authorization for a named flow and its boundaries: your own account, permission to generate a key, secure local storage of the key, init and the first agreed card (goal, directory, write scope and result criteria).
|
|
41
|
+
At the start, ask once for authorization for a named flow and its boundaries: your own account, permission to generate a key, secure local storage of the key, init and the first agreed card (goal, directory, write scope and result criteria). Before asking for authorization, agree with the owner on the local `greet.cjs` card or the manual `wynik.txt` card; the boundaries must match the chosen example.
|
|
42
42
|
|
|
43
43
|
If the owner has already authorized this flow, do not ask again at those steps; continue within the agreed boundaries. A missing authorization, null, empty or unclear answer or scope change requires a question before the dependent step; continue independent authorized work. Respect a refusal: do not perform the refused steps. Authorization does not bypass protected human or provider confirmations; continue after confirmation. Keep the key out of chat, cards, arguments and command history; if secure storage or transfer is unavailable, the human uses init's hidden prompt. Someone else's open session gives no access to their account. Independent review and separate final acceptance of the result by the owner are still required.
|
|
44
44
|
<!-- agent-consent:end -->
|
|
@@ -49,9 +49,9 @@ At https://robisie.app/dashboard/connect the human selects `worker` and a recogn
|
|
|
49
49
|
|
|
50
50
|
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.
|
|
51
51
|
|
|
52
|
-
|
|
52
|
+
For manual installation from Connect, 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.
|
|
53
53
|
|
|
54
|
-
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.
|
|
54
|
+
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. For manual installation 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.
|
|
55
55
|
|
|
56
56
|
When key A sees exactly one project, doctor reads `reviewPolicy` via `list_projects`: `enforced` prints “✓ Polityka enforced: TAK”; `legacy` warns that `accept_review` will be refused and directs you to the operator. A missing/null server field prints “NIE SPRAWDZONO — serwer nie zwraca polityki”; a read failure prints “NIE SPRAWDZONO — odczyt nieudany”. This informational line does not change the exit code. Project-context refusal happens before doctor and has separate advice. The client only reads the policy; an authorized operator changes it.
|
|
57
57
|
|
|
@@ -67,6 +67,14 @@ After sign-in, init, doctor and `npx robisie factory run` take A and B from the
|
|
|
67
67
|
|
|
68
68
|
The tester release is a single trust zone: on this computer the agent executing tasks technically also has access to the acceptance key (B). Run only agents you trust as yourself on it.
|
|
69
69
|
|
|
70
|
+
<!-- credential-sources:start -->
|
|
71
|
+
After `login`, `init`, `doctor` and `factory run` use A/B from the `key` and `review-key` files. A different nonempty stale ENV value is ignored with a warning without exposing its value; missing or damaged files need repair, not ENV fallback. This applies to robisie commands, not separate agent sessions.
|
|
72
|
+
|
|
73
|
+
Manual installation from Connect (without login) keeps ENV-first: valid ENV takes priority over saved keys. With empty A ENV, init uses the saved file for an existing installation unless `--key-stdin` was selected, then the hidden prompt or explicit stdin; for B it uses the existing installation's saved file, then the hidden prompt. A nonempty invalid key, read error or symlink needs repair without switching sources. Manual doctor requires both environment variables, including with `--no-shell`.
|
|
74
|
+
|
|
75
|
+
Separate agents: Claude Code uses the `Authorization` header saved by init in private configuration; Codex uses `bearer_token_env_var = "ROBISIE_KEY"`, and OpenCode uses `{env:ROBISIE_KEY}`. Codex/OpenCode need current A in the session environment even after login; load it without printing using the init recipe. B is not an agent configuration key. After changing keys, repeat init for the selected provider and start a new session.
|
|
76
|
+
<!-- credential-sources:end -->
|
|
77
|
+
|
|
70
78
|
<!-- sekcja: instalacja -->
|
|
71
79
|
<a id="instalacja"></a>
|
|
72
80
|
## Install from npm
|
|
@@ -161,7 +169,7 @@ For Codex or OpenCode replace `claude` with `codex` or `opencode`. With existing
|
|
|
161
169
|
|
|
162
170
|
The human chooses one shared provider for all three roles. The commands below set a complete map for both a new install and an existing map. `--agent` alone does not clear a map. Without `--agent`, the installer includes all detected providers; several without assignments produce a null map.
|
|
163
171
|
|
|
164
|
-
|
|
172
|
+
For manual installation without login, in zsh/bash remove stale ENV before init; it takes priority over the prompt and stdin:
|
|
165
173
|
|
|
166
174
|
```sh
|
|
167
175
|
unset ROBISIE_KEY
|
|
@@ -237,6 +245,73 @@ Doctor runs the helper file via node, the agent via npx. `ROBISIE_PROJECT_CONTEX
|
|
|
237
245
|
|
|
238
246
|
### Card for the local engine
|
|
239
247
|
|
|
248
|
+
After the npm installation above, prepare the repo in that same previously empty directory with this block. `Robisie Demo <demo@example.invalid>` is an explicit identity local to this exercise; use your own for a real project. Writes use `wx`: if a file exists or a write fails, preserve data, resolve the cause and stop subsequent steps. `.gitignore` excludes the local npm installation, configuration and usage input from this small repo; its product is `greet.cjs`.
|
|
249
|
+
|
|
250
|
+
<!-- local-repo-setup:start -->
|
|
251
|
+
```sh
|
|
252
|
+
git init --initial-branch=main &&
|
|
253
|
+
git config --local user.name "Robisie Demo" &&
|
|
254
|
+
git config --local user.email "demo@example.invalid" &&
|
|
255
|
+
node <<'NODE' &&
|
|
256
|
+
try {
|
|
257
|
+
require("node:fs").writeFileSync("greet.cjs", String.raw`try {
|
|
258
|
+
const greeting = "Witaj";
|
|
259
|
+
const recipient = process.argv[2];
|
|
260
|
+
if (recipient === undefined) console.log(greeting);
|
|
261
|
+
else {
|
|
262
|
+
if (process.argv.length !== 3 || !["Ala", "Bartek", "Celina"].includes(recipient)) throw new Error("Nieznany odbiorca");
|
|
263
|
+
const message = greeting + ", " + recipient + "!\n";
|
|
264
|
+
require("node:fs").writeFileSync("greeting.txt", message, { flag: "wx" });
|
|
265
|
+
process.stdout.write(message);
|
|
266
|
+
}
|
|
267
|
+
} catch (error) { console.error(error); process.exitCode = 1; }
|
|
268
|
+
`, { flag: "wx" });
|
|
269
|
+
require("node:fs").writeFileSync(".gitignore", "node_modules/\npackage.json\npackage-lock.json\nrobisie.config.json\nusage.json\ngreeting.txt\n", { flag: "wx" });
|
|
270
|
+
} catch (error) { console.error(error); process.exitCode = 1; }
|
|
271
|
+
NODE
|
|
272
|
+
git add greet.cjs .gitignore &&
|
|
273
|
+
git commit -m "Przygotuj lokalne powitanie"
|
|
274
|
+
```
|
|
275
|
+
<!-- local-repo-setup:end -->
|
|
276
|
+
|
|
277
|
+
Save the entire JSON below as `robisie.config.json` in the repo directory, without overwriting existing configuration. **Replace** fictitious `project` with the UUID from authenticated `list_projects`, and the `tracks` UUID and name with a real track from that project’s board. Replace `engine.repo` with the absolute current repo path and `stateDir` with a separate directory **outside the repo**. Complete all four `roleRegistry` entries. In the local flow, `worker-client` must use `provider: codex`, and `reviewer-client` must use `provider: grok`, `model: grok-cli`, `effort: none`. Another pair will stop at `HOLD clientPair`, even if it passes configuration validation. For Codex roles, choose a real model available on your account and supported effort; this example uses `gpt-6.1-sol` / `high`, not fixture models. The installed Grok CLI selects the reviewer model; keep `grok-cli` / `none`. The local flow needs available, signed-in `codex` and `grok` programs; the installer provider’s program alone is insufficient. Parsing and offline doctor do not prove model/provider availability. This execution registry is separate from the installer’s CEO/Builder/Quality Officer map.
|
|
278
|
+
|
|
279
|
+
<!-- local-engine-config:start -->
|
|
280
|
+
```json
|
|
281
|
+
{
|
|
282
|
+
"project": "11111111-1111-4111-8111-111111111111",
|
|
283
|
+
"tracks": [{"id": "22222222-2222-4222-8222-222222222222", "name": "Zmiany"}],
|
|
284
|
+
"stateDir": "/sciezka/do/stanu",
|
|
285
|
+
"engine": {
|
|
286
|
+
"mode": "client", "delivery": "local",
|
|
287
|
+
"repo": "/sciezka/do/repo", "branch": "main", "requiredChecks": [],
|
|
288
|
+
"commands": {
|
|
289
|
+
"test": ["node", "greet.cjs"],
|
|
290
|
+
"lint": ["node", "--check", "greet.cjs"],
|
|
291
|
+
"build": ["node", "--check", "greet.cjs"]
|
|
292
|
+
}
|
|
293
|
+
},
|
|
294
|
+
"roleRegistry": {
|
|
295
|
+
"worker-client": {"name": "Worker", "provider": "codex", "model": "gpt-6.1-sol", "effort": "high"},
|
|
296
|
+
"lead-client": {"name": "Lead", "provider": "codex", "model": "gpt-6.1-sol", "effort": "high"},
|
|
297
|
+
"reviewer-client": {"name": "Reviewer", "provider": "grok", "model": "grok-cli", "effort": "none"},
|
|
298
|
+
"tester-client": {"name": "Tester", "provider": "codex", "model": "gpt-6.1-sol", "effort": "high"}
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
```
|
|
302
|
+
<!-- local-engine-config:end -->
|
|
303
|
+
|
|
304
|
+
After replacing and saving configuration, prepare local engine inputs; init creates the project goal and tester safety list in `stateDir/inputs`. Continue only after ordinary doctor exits 0; offline validation alone does not check account or executor readiness.
|
|
305
|
+
|
|
306
|
+
```sh
|
|
307
|
+
npx robisie init &&
|
|
308
|
+
npx robisie doctor
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
Start the CEO in this directory: `claude --agent ceo-client`, or `codex` with the robisie CEO role and the full file referenced by AGENTS.md, or `opencode` selecting `ceo-client`. Give it this request:
|
|
312
|
+
|
|
313
|
+
> CEO, create a local card to change greet.cjs using the goal and literal details object below. Use the real project from list_projects and its board track. Change only greet.cjs, without dependencies, accounts or publication. Use my existing authorization if it covers this goal, directory, scope and acceptance; otherwise ask before dependent work. Supply actual authoring providers and a future deadline, then prepare the card as ready. After execution I need an independent tester and ACK, three uses for Ala/Bartek/Celina, and separate final acceptance.
|
|
314
|
+
|
|
240
315
|
Choose a project with policy `enforced` and `engine.delivery: "local"` using the [engine configuration](ENGINE-CONFIG.md). The CEO creates a card through the board tools with the literal `details` object below; the dashboard cannot edit `details`. Goal: change the greeting in an existing tracked `greet.cjs`; without arguments print `Witaj z fabryki`, and with one argument Ala, Bartek or Celina create a new `greeting.txt` containing `Witaj z fabryki, <name>!` and a trailing newline. No dependencies, accounts or publication. The code write scope is only `greet.cjs`; `greeting.txt` is a usage artifact in a separate worktree.
|
|
241
316
|
|
|
242
317
|
<!-- local-card-details:start -->
|
|
@@ -255,7 +330,7 @@ Choose a project with policy `enforced` and `engine.delivery: "local"` using the
|
|
|
255
330
|
|
|
256
331
|
Before creating the card, replace the example `deadline` with a future ISO 8601 timestamp including a timezone and enough time for execution, the tester and three uses. In `seed_provenance.authoring_providers`, record the actual providers of the seed author (`by`), proposal author (`proposal_by`) and package author (`packager_by`); copying example providers does not establish independence. The engine supplies transport, delivery and tester results; do not manufacture these records.
|
|
257
332
|
|
|
258
|
-
After authorization, the CEO prepares the card as `ready`. Run `npx robisie factory run --engine-config ./robisie.config.json --once` and observe the card until a real tester PASS on the landed SHA and settlement (ACK): no `.tester-job.lock`, `.tester-job.input.json` or `.tester-job.result.json` in `stateDir`. PASS without ACK is insufficient.
|
|
333
|
+
After authorization, the CEO prepares the card as `ready`. Run `npx robisie factory run --engine-config ./robisie.config.json --once` and observe the card until a real tester PASS on the landed SHA and settlement (ACK): no `.tester-job.lock`, `.tester-job.input.json` or `.tester-job.result.json` in `stateDir`. PASS without ACK is insufficient. A fresh `get_task({id, include:["test","landed","local_receiver"]})` (the created card’s id) must show `details.test.verdict=PASS` and `details.test.sha=details.landed.sha`; process transport alone is not tester PASS.
|
|
259
334
|
|
|
260
335
|
Save the complete input below as `usage.json` in the current directory. Take `repo` from `engine.repo` and `stateDir` from engine configuration (resolve relative configuration paths against its directory; use absolute paths here). Copy `landed.sha` and `landed.at` from a fresh read of this card's `details.landed`; the values below are fictitious. Copy `source` and `deadline` from the JSON text in `details.effect_check`; `source` is relative to `stateDir/evidence`.
|
|
261
336
|
|
|
@@ -279,7 +354,7 @@ npx robisie usage --input ./usage.json
|
|
|
279
354
|
|
|
280
355
|
Success prints one JSON `UsageEvent` with exit 0. Change `operation` to `powitanie:Bartek` and `program.args` to `["Bartek"]`, run the same command, then repeat with `powitanie:Celina` and `["Celina"]`. The equivalent `--input=./usage.json` form is supported. Three distinct operations and distinct artifact bytes are required; three identical operations do not count as three. Do not append events manually. The CLI executes the landed SHA in a separate worktree; it does not judge the result or set `done`.
|
|
281
356
|
|
|
282
|
-
Refusal or IO failure returns exit 1 and a next step. An entry may already exist: inspect `stateDir/evidence/<source>` and the referenced artifacts before retrying, preserve evidence and resolve the cause. Never retry the program automatically. After three accepted uses, another `factory run --once` tick starts/settles independent acceptance; only a fresh
|
|
357
|
+
Refusal or IO failure returns exit 1 and a next step. An entry may already exist: inspect `stateDir/evidence/<source>` and the referenced artifacts before retrying, preserve evidence and resolve the cause. Never retry the program automatically. After three accepted uses, another `factory run --once` tick starts/settles independent acceptance; only a fresh `get_task({id, include:["test","landed","local_receiver"]})` confirms `details.local_receiver.outcome=PASS` and `status=done`. The package fixture does not prove actual customer use.
|
|
283
358
|
|
|
284
359
|
### Manual Builder card
|
|
285
360
|
|
|
@@ -419,7 +494,7 @@ cp -p -- "$backup/profile/selected" "$profile"
|
|
|
419
494
|
cp -p -- "$backup/entries/$entry_id" "$entry_path"
|
|
420
495
|
```
|
|
421
496
|
|
|
422
|
-
Once the tgz and selected copies are ready, update.
|
|
497
|
+
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:
|
|
423
498
|
|
|
424
499
|
<!-- update:start -->
|
|
425
500
|
```sh
|
|
@@ -506,7 +581,7 @@ Retained backups, including private update copies, may still contain the key aft
|
|
|
506
581
|
<!-- sekcja: diagnoza -->
|
|
507
582
|
## Diagnosis
|
|
508
583
|
|
|
509
|
-
Without an installation, begin with the account and Connect → init; repeating doctor does not create an account. With an existing installation, doctor reads the record and key first (
|
|
584
|
+
Without an installation, begin with the account and Connect → init; repeating doctor does not create an account. With an existing installation, doctor reads the record and key first (after login: installation files; manual installation: ENV-first), then checks the network. Resolve record/key-read problems first while preserving data; a network failure on an existing installation does not call for a new account. Check connectivity and server access.
|
|
510
585
|
|
|
511
586
|
CLI messages remain in Polish. Match the message, then follow the English explanation:
|
|
512
587
|
|
|
@@ -538,4 +613,4 @@ The installer does not start background services or the Builder on its own; afte
|
|
|
538
613
|
|
|
539
614
|
Windows/WSL are unverified. Offline validation checks configuration structure, not project UUID, repo existence, model availability or provider execution.
|
|
540
615
|
|
|
541
|
-
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`
|
|
616
|
+
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` on Linux for the client (`local`), or on Linux and macOS for an explicit Robisie host (`mode: "host"`, `pr|delivered`). Other systems receive 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; a live macOS host switch and return require separate operator acceptance. 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
|
+
# robisie — od konta do odebranej karty (paczka 0.5.1) <!-- 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
|
|
|
@@ -19,7 +19,7 @@ Jeśli README w rejestrze jest puste, użyj lokalnych przewodników w `node_modu
|
|
|
19
19
|
<a id="wymagania"></a>
|
|
20
20
|
## Wymagania
|
|
21
21
|
|
|
22
|
-
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
|
|
22
|
+
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`) dla klienta wymaga systemu Linux; jawny host Robisie (`engine.mode: "host"`, dostawa `pr|delivered`) może działać także na macOS. Uruchamia go `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.
|
|
23
23
|
|
|
24
24
|
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.
|
|
25
25
|
|
|
@@ -40,7 +40,7 @@ Odczyt projektów to uwierzytelniony odczyt aktywnych projektów przez `list_pro
|
|
|
40
40
|
<!-- agent-consent:start -->
|
|
41
41
|
### Instrukcja dla agenta — jedna zgoda na przebieg
|
|
42
42
|
|
|
43
|
-
Na początku poproś raz o zgodę na nazwany przebieg i jego granice: własne konto, wygenerowanie klucza, bezpieczny lokalny zapis klucza, init oraz pierwszą uzgodnioną kartę (cel, katalog, zakres zapisu i kryteria wyniku).
|
|
43
|
+
Na początku poproś raz o zgodę na nazwany przebieg i jego granice: własne konto, wygenerowanie klucza, bezpieczny lokalny zapis klucza, init oraz pierwszą uzgodnioną kartę (cel, katalog, zakres zapisu i kryteria wyniku). Przed prośbą o zgodę wybierz z właścicielem lokalną kartę `greet.cjs` albo ręczną `wynik.txt`; granice muszą odpowiadać wybranemu przykładowi.
|
|
44
44
|
|
|
45
45
|
Jeśli właściciel już udzielił zgody na ten przebieg, nie pytaj ponownie przy tych krokach; kontynuuj w ustalonych granicach. Brak zgody, null, pusta lub niejasna odpowiedź albo zmiana zakresu wymagają pytania przed zależnym krokiem; wykonuj dalej niezależne dozwolone czynności. Odmowę uszanuj: nie wykonuj odmówionych kroków. Zgoda nie omija chronionych potwierdzeń człowieka ani dostawcy; po takim potwierdzeniu kontynuuj. Klucz pozostaje poza rozmową, kartą, argumentami i historią poleceń; gdy bezpieczny zapis lub przekazanie nie jest dostępne, człowiek używa ukrytego pytania init. Cudza otwarta sesja nie daje dostępu do jej konta. Po pracy nadal obowiązują niezależna recenzja oraz osobny końcowy odbiór wyniku przez właściciela.
|
|
46
46
|
<!-- agent-consent:end -->
|
|
@@ -51,9 +51,17 @@ Człowiek w https://robisie.app/dashboard/connect wybiera `worker` i własną ro
|
|
|
51
51
|
|
|
52
52
|
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.
|
|
53
53
|
|
|
54
|
-
|
|
54
|
+
Przy ręcznej instalacji z Connect 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.
|
|
55
55
|
|
|
56
|
-
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.
|
|
56
|
+
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. Przy ręcznej instalacji 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.
|
|
57
|
+
|
|
58
|
+
<!-- credential-sources:start -->
|
|
59
|
+
Po `login` polecenia `init`, `doctor` i `factory run` używają A/B z plików `key` i `review-key`. Różny niepusty stary ENV jest ignorowany z ostrzeżeniem bez ujawniania wartości; brak lub uszkodzenie plików wymaga naprawy, nie fallbacku do ENV. Dotyczy to poleceń robisie, a nie osobnych sesji agentów.
|
|
60
|
+
|
|
61
|
+
Instalacja ręczna z Connect (bez login) zachowuje ENV-first: poprawny ENV ma pierwszeństwo przed zapisanym kluczem. Dla A przy pustym ENV init używa zapisanego pliku, jeśli istnieje instalacja i nie wybrano `--key-stdin`, potem ukrytego pytania lub jawnego stdin; dla B używa zapisanego pliku istniejącej instalacji, potem ukrytego pytania. Niepusty wadliwy klucz, błąd odczytu lub dowiązanie wymagają naprawy, bez zastępowania innym źródłem. Ręczny doctor wymaga obu ENV, także przy `--no-shell`.
|
|
62
|
+
|
|
63
|
+
Osobni agenci: Claude Code używa nagłówka `Authorization` zapisanego przez init w prywatnej konfiguracji; Codex używa `bearer_token_env_var = "ROBISIE_KEY"`, a OpenCode referencji `{env:ROBISIE_KEY}`. Codex/OpenCode wymagają aktualnego A w środowisku sesji także po login; wczytaj je bez wydruku według przepisu init. B nie jest kluczem konfiguracji agentów. Po zmianie kluczy ponów init dla wybranego dostawcy i rozpocznij nową sesję.
|
|
64
|
+
<!-- credential-sources:end -->
|
|
57
65
|
|
|
58
66
|
Gdy klucz A widzi dokładnie jeden projekt, doctor odczytuje jego `reviewPolicy` przez `list_projects`: `enforced` daje „✓ Polityka enforced: TAK”, `legacy` ostrzega, że `accept_review` będzie odmawiane i wymaga ustawienia enforced przez operatora. Starszy serwer bez pola lub `null` daje „NIE SPRAWDZONO — serwer nie zwraca polityki”, błąd odczytu — „NIE SPRAWDZONO — odczyt nieudany”. Linia jest informacyjna i nie zmienia exit. Odmowa kontekstu projektu następuje przed doctor i ma własną poradę. Klient tylko odczytuje politykę, nie aktywuje enforced; zmienia ją uprawniony operator.
|
|
59
67
|
|
|
@@ -204,7 +212,7 @@ npx robisie doctor
|
|
|
204
212
|
|
|
205
213
|
Człowiek wybiera jednego wspólnego dostawcę dla trzech ról. Polecenia poniżej ustawiają pełną mapę zarówno przy nowej instalacji, jak i wcześniejszej mapie. Samo `--agent` nie kasuje mapy. Bez `--agent` instalator uwzględnia wszystkich wykrytych dostawców; kilku bez przypisań daje mapę null.
|
|
206
214
|
|
|
207
|
-
|
|
215
|
+
Przy ręcznej instalacji bez login w zsh/bash przed init usuń stary ENV, który ma pierwszeństwo przed pytaniem i stdin:
|
|
208
216
|
|
|
209
217
|
```sh
|
|
210
218
|
unset ROBISIE_KEY
|
|
@@ -282,6 +290,73 @@ Doctor uruchamia plik pomocnika przez node, agent przez npx. `ROBISIE_PROJECT_CO
|
|
|
282
290
|
|
|
283
291
|
### Karta dla lokalnego silnika
|
|
284
292
|
|
|
293
|
+
Po instalacji npm z sekcji powyżej, w tym samym pustym dotąd katalogu przygotuj repo poniższym blokiem. Tożsamość `Robisie Demo <demo@example.invalid>` jest jawna i lokalna dla tego ćwiczenia; dla własnego projektu ustaw własną. Zapis używa `wx`: przy istniejącym pliku lub błędzie zachowaj dane, wyjaśnij przyczynę i nie wykonuj dalszych kroków. `.gitignore` wyłącza lokalną instalację npm, konfigurację i input użycia z tego małego repo; produktem jest `greet.cjs`.
|
|
294
|
+
|
|
295
|
+
<!-- local-repo-setup:start -->
|
|
296
|
+
```sh
|
|
297
|
+
git init --initial-branch=main &&
|
|
298
|
+
git config --local user.name "Robisie Demo" &&
|
|
299
|
+
git config --local user.email "demo@example.invalid" &&
|
|
300
|
+
node <<'NODE' &&
|
|
301
|
+
try {
|
|
302
|
+
require("node:fs").writeFileSync("greet.cjs", String.raw`try {
|
|
303
|
+
const greeting = "Witaj";
|
|
304
|
+
const recipient = process.argv[2];
|
|
305
|
+
if (recipient === undefined) console.log(greeting);
|
|
306
|
+
else {
|
|
307
|
+
if (process.argv.length !== 3 || !["Ala", "Bartek", "Celina"].includes(recipient)) throw new Error("Nieznany odbiorca");
|
|
308
|
+
const message = greeting + ", " + recipient + "!\n";
|
|
309
|
+
require("node:fs").writeFileSync("greeting.txt", message, { flag: "wx" });
|
|
310
|
+
process.stdout.write(message);
|
|
311
|
+
}
|
|
312
|
+
} catch (error) { console.error(error); process.exitCode = 1; }
|
|
313
|
+
`, { flag: "wx" });
|
|
314
|
+
require("node:fs").writeFileSync(".gitignore", "node_modules/\npackage.json\npackage-lock.json\nrobisie.config.json\nusage.json\ngreeting.txt\n", { flag: "wx" });
|
|
315
|
+
} catch (error) { console.error(error); process.exitCode = 1; }
|
|
316
|
+
NODE
|
|
317
|
+
git add greet.cjs .gitignore &&
|
|
318
|
+
git commit -m "Przygotuj lokalne powitanie"
|
|
319
|
+
```
|
|
320
|
+
<!-- local-repo-setup:end -->
|
|
321
|
+
|
|
322
|
+
Zapisz cały poniższy JSON jako `robisie.config.json` w katalogu repo, bez nadpisywania istniejącej konfiguracji. **Podmień** fikcyjne `project` na UUID z uwierzytelnionego `list_projects`, a UUID i nazwę `tracks` na rzeczywisty tor z tablicy tego projektu. Podmień `engine.repo` na absolutną ścieżkę bieżącego repo, a `stateDir` na osobny katalog **poza repo**. Uzupełnij wszystkie cztery wpisy `roleRegistry`. W lokalnym przebiegu `worker-client` musi używać `provider: codex`, a `reviewer-client` musi używać `provider: grok`, `model: grok-cli`, `effort: none`. Inna para zostanie zatrzymana przez `HOLD clientPair`, nawet jeśli przejdzie walidację konfiguracji. Dla ról Codex wybierz rzeczywisty model dostępny na swoim koncie i obsługiwany effort; przykład używa `gpt-6.1-sol` / `high`, nie modeli fixture. Model recenzenta wybiera zainstalowany Grok CLI; zachowaj `grok-cli` / `none`. Lokalny przebieg wymaga dostępnych i zalogowanych programów `codex` i `grok`; sam program dostawcy instalatora nie wystarcza. Same parsowanie i doctor offline nie dowodzą dostępności modeli ani dostawców. Rejestr wykonania jest odrębny od mapy instalatora CEO/Builder/Quality Officer.
|
|
323
|
+
|
|
324
|
+
<!-- local-engine-config:start -->
|
|
325
|
+
```json
|
|
326
|
+
{
|
|
327
|
+
"project": "11111111-1111-4111-8111-111111111111",
|
|
328
|
+
"tracks": [{"id": "22222222-2222-4222-8222-222222222222", "name": "Zmiany"}],
|
|
329
|
+
"stateDir": "/sciezka/do/stanu",
|
|
330
|
+
"engine": {
|
|
331
|
+
"mode": "client", "delivery": "local",
|
|
332
|
+
"repo": "/sciezka/do/repo", "branch": "main", "requiredChecks": [],
|
|
333
|
+
"commands": {
|
|
334
|
+
"test": ["node", "greet.cjs"],
|
|
335
|
+
"lint": ["node", "--check", "greet.cjs"],
|
|
336
|
+
"build": ["node", "--check", "greet.cjs"]
|
|
337
|
+
}
|
|
338
|
+
},
|
|
339
|
+
"roleRegistry": {
|
|
340
|
+
"worker-client": {"name": "Worker", "provider": "codex", "model": "gpt-6.1-sol", "effort": "high"},
|
|
341
|
+
"lead-client": {"name": "Lead", "provider": "codex", "model": "gpt-6.1-sol", "effort": "high"},
|
|
342
|
+
"reviewer-client": {"name": "Reviewer", "provider": "grok", "model": "grok-cli", "effort": "none"},
|
|
343
|
+
"tester-client": {"name": "Tester", "provider": "codex", "model": "gpt-6.1-sol", "effort": "high"}
|
|
344
|
+
}
|
|
345
|
+
}
|
|
346
|
+
```
|
|
347
|
+
<!-- local-engine-config:end -->
|
|
348
|
+
|
|
349
|
+
Po podmianie i zapisaniu konfiguracji przygotuj wejścia lokalnego silnika; init utworzy cel projektu i listę ochrony testera w `stateDir/inputs`. Kontynuuj dopiero po zwykłym doctor z exit 0; sama walidacja offline nie sprawdza konta ani gotowości wykonawców.
|
|
350
|
+
|
|
351
|
+
```sh
|
|
352
|
+
npx robisie init &&
|
|
353
|
+
npx robisie doctor
|
|
354
|
+
```
|
|
355
|
+
|
|
356
|
+
Uruchom CEO w tym katalogu: `claude --agent ceo-client`, albo `codex` z rolą robisie CEO i pełnym odczytem pliku wskazanego w AGENTS.md, albo `opencode` z wyborem `ceo-client`. Przekaż mu gotową prośbę:
|
|
357
|
+
|
|
358
|
+
> CEO, utwórz lokalną kartę zmiany greet.cjs według celu i literalnego obiektu details poniżej. Użyj rzeczywistego projektu z list_projects i toru z tablicy. Zmień wyłącznie greet.cjs, bez zależności, kont i publikacji. Korzystaj z wcześniejszej zgody, jeśli obejmuje ten cel, katalog, zakres i odbiór; inaczej zapytaj przed zależnym krokiem. Wstaw prawdziwych dostawców autorstwa i przyszły deadline, przygotuj kartę do ready. Po pracy potrzebuję niezależnego testera i ACK, trzech użyć Ala/Bartek/Celina oraz osobnego końcowego odbioru.
|
|
359
|
+
|
|
285
360
|
Wybierz projekt z polityką `enforced` i konfiguracją `engine.delivery: "local"` według [konfiguracji silnika](ENGINE-CONFIG.md). CEO tworzy kartę przez narzędzia tablicy, z poniższym literalnym obiektem `details`. Panel nie edytuje `details`. Cel: zmień powitanie w istniejącym, śledzonym `greet.cjs`; bez argumentu wypisz `Witaj z fabryki`, a dla jednego argumentu Ala, Bartek lub Celina zapisz nowe `greeting.txt` z `Witaj z fabryki, <imię>!` i końcowym znakiem nowej linii. Bez zależności, kont i publikacji. Zakres zapisu kodu obejmuje tylko `greet.cjs`; `greeting.txt` jest artefaktem użycia w osobnym worktree.
|
|
286
361
|
|
|
287
362
|
<!-- local-card-details:start -->
|
|
@@ -300,7 +375,7 @@ Wybierz projekt z polityką `enforced` i konfiguracją `engine.delivery: "local"
|
|
|
300
375
|
|
|
301
376
|
Przed utworzeniem karty zastąp przykładowy `deadline` przyszłym terminem ISO 8601 ze strefą czasową, obejmującym wykonanie, testera i trzy użycia. W `seed_provenance.authoring_providers` wpisz prawdziwych dostawców autorów: `by` autora zasiewu, `proposal_by` autora propozycji, `packager_by` autora pakietu; nie kopiuj przykładowych nazw dla pozorowania niezależności. Silnik dopisuje transport, dostawę i wynik testera — nie twórz tych dowodów ręcznie.
|
|
302
377
|
|
|
303
|
-
Po autoryzacji CEO przygotowuje kartę do `ready`. Uruchamiaj `npx robisie factory run --engine-config ./robisie.config.json --once` i obserwuj kartę aż do rzeczywistego PASS testera na landed SHA oraz jego rozliczenia (ACK): brak `.tester-job.lock`, `.tester-job.input.json` i `.tester-job.result.json` w `stateDir`. Sam PASS bez ACK nie wystarcza.
|
|
378
|
+
Po autoryzacji CEO przygotowuje kartę do `ready`. Uruchamiaj `npx robisie factory run --engine-config ./robisie.config.json --once` i obserwuj kartę aż do rzeczywistego PASS testera na landed SHA oraz jego rozliczenia (ACK): brak `.tester-job.lock`, `.tester-job.input.json` i `.tester-job.result.json` w `stateDir`. Sam PASS bez ACK nie wystarcza. Świeży odczyt `get_task({id, include:["test","landed","local_receiver"]})` (id utworzonej karty) musi pokazać `details.test.verdict=PASS` oraz `details.test.sha=details.landed.sha`; sam transport procesu nie jest PASS testera.
|
|
304
379
|
|
|
305
380
|
Zapisz poniższy pełny input jako `usage.json` w bieżącym katalogu. `repo` weź z `engine.repo`, a `stateDir` z konfiguracji silnika (ścieżki względne konfiguracji rozwiąż względem jej katalogu; tu użyj absolutnych). `landed.sha` i `landed.at` przepisz ze świeżego odczytu `details.landed` tej karty — poniższe wartości są fikcyjne. `source` i `deadline` przepisz z JSON w `details.effect_check`; `source` jest względem `stateDir/evidence`.
|
|
306
381
|
|
|
@@ -324,7 +399,7 @@ npx robisie usage --input ./usage.json
|
|
|
324
399
|
|
|
325
400
|
Po sukcesie otrzymasz jeden `UsageEvent` JSON i exit 0. Zmień `operation` na `powitanie:Bartek` oraz `program.args` na `["Bartek"]` i wykonaj to samo polecenie, potem analogicznie `powitanie:Celina` i `["Celina"]`. Możesz użyć równoważnego `--input=./usage.json`. Potrzebne są trzy różne operacje i różne bajty artefaktów; trzy identyczne operacje nie liczą się jako trzy. Nie dopisuj zdarzeń ręcznie. CLI wykonuje program na landed SHA w osobnym worktree, nie ocenia wyniku i nie ustawia `done`.
|
|
326
401
|
|
|
327
|
-
Przy odmowie lub błędzie IO polecenie zwraca exit 1 z następnym krokiem. Wpis może już istnieć: przed ponowieniem sprawdź `stateDir/evidence/<source>` oraz wskazane artefakty, zachowaj dowody i wyjaśnij przyczynę. Nie ponawiaj programu automatycznie. Po trzech przyjętych użyciach kolejny takt `factory run --once` uruchamia/rozlicza niezależny odbiór; dopiero świeży
|
|
402
|
+
Przy odmowie lub błędzie IO polecenie zwraca exit 1 z następnym krokiem. Wpis może już istnieć: przed ponowieniem sprawdź `stateDir/evidence/<source>` oraz wskazane artefakty, zachowaj dowody i wyjaśnij przyczynę. Nie ponawiaj programu automatycznie. Po trzech przyjętych użyciach kolejny takt `factory run --once` uruchamia/rozlicza niezależny odbiór; dopiero świeży `get_task({id, include:["test","landed","local_receiver"]})` potwierdza `details.local_receiver.outcome=PASS` i `status=done`. Lokalny przykład w testach paczki nie dowodzi użycia u klienta.
|
|
328
403
|
|
|
329
404
|
### Ręczna karta Buildera
|
|
330
405
|
|
|
@@ -464,7 +539,7 @@ cp -p -- "$backup/profile/selected" "$profile"
|
|
|
464
539
|
cp -p -- "$backup/entries/$entry_id" "$entry_path"
|
|
465
540
|
```
|
|
466
541
|
|
|
467
|
-
Gdy tgz i wszystkie wybrane kopie są gotowe, aktualizuj.
|
|
542
|
+
Gdy tgz i wszystkie wybrane kopie są gotowe, aktualizuj. Po login init i doctor używają A/B z plików instalacji, ignorując różny stary ENV z ostrzeżeniem. Przy ręcznej instalacji bez login init używa zapisanych A/B z ENV-first; jawny `--key-stdin` wybiera wejście dla A. Ręczny doctor wymaga obu ENV; źródła kluczy agentów zależą od dostawcy jak opisano wyżej. Wczytaj stary klucz PRZED init/doctor z tego samego XDG_CONFIG_HOME; osobne przypisanie przed export i `&&` zachowują błąd odczytu bez wydruku klucza:
|
|
468
543
|
|
|
469
544
|
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.
|
|
470
545
|
|
|
@@ -551,7 +626,7 @@ Zachowane backupy, także prywatne kopie aktualizacji, mogą nadal zawierać klu
|
|
|
551
626
|
<!-- sekcja: diagnoza -->
|
|
552
627
|
## Diagnoza
|
|
553
628
|
|
|
554
|
-
Bez instalacji zacznij od konta i Connect → init; samo ponawianie doctor nie zakłada konta. Przy istniejącej instalacji doctor najpierw odczytuje ewidencję i klucz (
|
|
629
|
+
Bez instalacji zacznij od konta i Connect → init; samo ponawianie doctor nie zakłada konta. Przy istniejącej instalacji doctor najpierw odczytuje ewidencję i klucz (po login: pliki instalacji; ręcznie: ENV-first), a potem sprawdza sieć. Najpierw rozwiąż wskazany problem ewidencji/odczytu klucza, zachowując dane; błąd sieci przy istniejącej instalacji nie oznacza potrzeby nowego konta. Sprawdź połączenie i dostęp do serwera.
|
|
555
630
|
|
|
556
631
|
Komunikaty CLI pozostają po polsku. Dopasuj komunikat, a potem wykonaj wskazaną czynność:
|
|
557
632
|
|
|
@@ -583,4 +658,4 @@ Instalator nie uruchamia sam usług w tle ani Buildera; po zgodzie operatora CEO
|
|
|
583
658
|
|
|
584
659
|
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.
|
|
585
660
|
|
|
586
|
-
Silnik paczki (`dist/engine/tick.cjs`) jest odrębny od instalatora: uruchamia go `npx robisie factory run --engine-config ./robisie.config.json`
|
|
661
|
+
Silnik paczki (`dist/engine/tick.cjs`) jest odrębny od instalatora: uruchamia go `npx robisie factory run --engine-config ./robisie.config.json` na Linuxie dla klienta (`local`) oraz na Linuxie lub macOS dla jawnego hosta Robisie (`mode: "host"`, `pr|delivered`). Pozostałe systemy otrzymują kod 2 i komunikat. 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; próba żywego hosta na macOS i jego powrotu wymaga osobnego odbioru operatora. Automatyczne plany FJ u klienta są zapowiedziane („wkrótce”), ale nie ma ich w tym wydaniu; selektor zwraca prawdziwy wynik.
|
package/package.json
CHANGED