robisie 0.1.3 → 0.1.4
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 +9 -0
- package/README.md +35 -9
- package/dist/constants.d.ts +1 -1
- package/dist/constants.js +1 -1
- package/dist/opencode-review-guard.js +7 -2
- package/dist/roles.d.ts +1 -1
- package/dist/seed-package.d.ts +10 -0
- package/dist/seed-package.js +62 -0
- package/dist/task-mktemp.d.ts +1 -0
- package/dist/task-mktemp.js +40 -0
- package/docs/README.en.md +107 -51
- package/docs/README.md +107 -51
- package/docs/RELEASE-0.1.0.md +2 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,14 @@
|
|
|
1
1
|
# Historia zmian klienta / Client changelog
|
|
2
2
|
|
|
3
|
+
## 0.1.4 (2026-11-04)
|
|
4
|
+
|
|
5
|
+
Wydanie poprawek dokumentacji. / Documentation patch release.
|
|
6
|
+
|
|
7
|
+
- Przewodniki PL/EN i README paczki opisują jednorazową zgodę agenta na nazwany przebieg (konto, klucz, init, pierwsza karta), oddzieloną od końcowego odbioru. / PL/EN guides and the package README describe the agent's one-time consent for a named run (account, key, init, first card), kept separate from final acceptance.
|
|
8
|
+
- Przewodniki wyjaśniają konfigurację ról: trzy role instalatora (`ceo`, `builder`, `quality`) z jednym dostawcą oraz ich odrębność od rejestru wykonania `roleRegistry`. / Guides explain role setup: three installer roles (`ceo`, `builder`, `quality`) with one provider and their separation from the `roleRegistry` execution registry.
|
|
9
|
+
- Ponowna instalacja: odmowa utworzenia istniejącego `package.json` podaje następny krok; aktualizacja przed pierwszym init (`npm i robisie@latest`, bez klucza) jest oddzielona od chronionej aktualizacji po init; polecenia kopii i przywracania przeniesiono z tabel do bloków bez zmiany ścieżek i kolejności. / Reinstallation: refusing to create an existing `package.json` names the next step; the pre-init update (`npm i robisie@latest`, keyless) is separated from the guarded post-init update; backup and restore commands moved from tables to code blocks without changing paths or order.
|
|
10
|
+
- Testy dokumentacji: nowy `docs-014` oraz dostosowane istniejące testy przewodników. / Documentation tests: new `docs-014` and adjusted existing guide tests.
|
|
11
|
+
|
|
3
12
|
## 0.1.3 (2026-11-04)
|
|
4
13
|
|
|
5
14
|
Wydanie poprawek dokumentacji i pomocy CLI. / Documentation and CLI help patch release.
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# robisie
|
|
2
2
|
|
|
3
|
-
Przewodniki: [PL — konto → odbiór → odinstalowanie](docs/README.md) · [EN — account → acceptance → uninstall](docs/README.en.md). Przygotuj Node.js 20+, npm, program jednego dostawcy AI oraz pusty katalog; 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
|
|
3
|
+
Przewodniki: [PL — konto → odbiór → odinstalowanie](docs/README.md) · [EN — account → acceptance → uninstall](docs/README.en.md). Przygotuj Node.js 20+, npm, program jednego dostawcy AI oraz pusty katalog; 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`.
|
|
4
4
|
|
|
5
5
|
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ę: nie potwierdza UUID projektu, repo, modeli ani uruchomienia dostawców. Lokalne przewodniki są w `node_modules/robisie/docs/`.
|
|
6
6
|
|
|
@@ -14,16 +14,26 @@ Jeśli trasa przekierowała na /dashboard bez Planera, znajdź „Zacznij od pie
|
|
|
14
14
|
|
|
15
15
|
## Init — połącz agenta
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
<!-- agent-consent:start -->
|
|
18
|
+
### Instrukcja dla agenta — jedna zgoda na przebieg
|
|
18
19
|
|
|
19
|
-
|
|
20
|
+
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). Przykład pierwszej karty poniżej obejmuje tylko `wynik.txt`; wybierz ją z właścicielem przed prośbą o zgodę.
|
|
21
|
+
|
|
22
|
+
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.
|
|
23
|
+
<!-- agent-consent:end -->
|
|
24
|
+
|
|
25
|
+
Trzy role instalatora używają jednego dostawcy: CEO (`ceo`), Builder (`builder`), Quality Officer (`quality`). Mieszana mapa nie uruchamia ról między dostawcami, a doctor zwraca kod 1. Dla Claude użyj pełnego przypisania `npx robisie init --agent claude --role ceo=claude --role builder=claude --role quality=claude` zamiast linii init poniżej. Dla Codex/OpenCode zastąp każde `claude` przez `codex`/`opencode`; samo `--agent` nie kasuje wcześniejszej mapy.
|
|
26
|
+
|
|
27
|
+
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.
|
|
28
|
+
|
|
29
|
+
Jawnie wybierz `worker` w Connect; kolejne klucze mają domyślnie `observer`, który tylko czyta. Człowiek generuje klucz worker z etykietą w https://robisie.app/dashboard/connect i podaje go poza rozmową do ukrytego pytania init, nigdy do czatu, argumentu polecenia ani historii powłoki. W zsh/bash usuń stary ENV, a po udanym init wczytaj zapisany klucz do bieżącej powłoki bez wyświetlania go — init nie ustawia jej środowiska. Dla nowej instalacji z Claude wejdź do wybranego pustego katalogu (zastąp przykładową ścieżkę poniżej). Poniższy krok Node.js tworzy lokalny `package.json` niezależnie od nazwy katalogu, także ze spacjami i polskimi znakami. Manifest ustala katalog instalacji także pod przodkiem z `node_modules`. Jeśli ścieżka `package.json` już istnieje (również jako link), krok odmawia zapisu; niczego nie nadpisuje. Błąd wejścia do katalogu lub utworzenia manifestu zatrzymuje dalszy blok:
|
|
20
30
|
|
|
21
31
|
```sh
|
|
22
32
|
cd "/ścieżka/do/pustego katalogu" &&
|
|
23
33
|
node -e 'try {
|
|
24
34
|
require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
|
|
25
35
|
} catch (error) {
|
|
26
|
-
console.error(
|
|
36
|
+
console.error("Nie można utworzyć package.json: ścieżka już istnieje albo jest niedostępna. Następny krok: zachowaj ją i przejdź do instrukcji istniejącego projektu/reinstalacji poniżej; link/katalog lub błąd dostępu wyjaśnij lokalnie przed ponowieniem.");
|
|
27
37
|
process.exit(1);
|
|
28
38
|
}' &&
|
|
29
39
|
{
|
|
@@ -49,7 +59,7 @@ npx robisie doctor
|
|
|
49
59
|
|
|
50
60
|
Łańcuch `&&` zatrzymuje blok po pierwszym błędzie; osobne przypisanie przed `export` zachowuje błąd odczytu klucza. Po naprawieniu przyczyny ponów nieudany krok i wszystkie następne w tym samym katalogu. Jeśli manifest już powstał, nie twórz go ponownie ani go nie usuwaj. Nie włączaj xtrace ani nie drukuj sekretu.
|
|
51
61
|
|
|
52
|
-
Dla istniejącego projektu bez `package.json` wykonaj powyższy blok nowej instalacji w katalogu tego projektu: tworzy tylko prywatny manifest i zachowuje pozostałe pliki. Jeśli zwykły manifest już istnieje albo reinstalujesz z zachowanym poprawnym kluczem, użyj poniższego bloku w wybranym katalogu projektu. Wczytuje zapisany klucz przed npm/init/doctor, nie nadpisuje zwykłego manifestu podczas przygotowania i tworzy go przez `wx` tylko przy braku. Samo npm może następnie dopisać zależność robisie oraz zmienić lockfile. Link manifestu (także wiszący) lub katalog odrzuca z wyjaśnieniem. Po uninstall
|
|
62
|
+
Dla istniejącego projektu bez `package.json` wykonaj powyższy blok nowej instalacji w katalogu tego projektu: tworzy tylko prywatny manifest i zachowuje pozostałe pliki. Jeśli zwykły manifest już istnieje albo reinstalujesz z zachowanym poprawnym kluczem, użyj poniższego bloku w wybranym katalogu projektu. Wczytuje zapisany klucz przed npm/init/doctor, nie nadpisuje zwykłego manifestu podczas przygotowania i tworzy go przez `wx` tylko przy braku. Samo npm może następnie dopisać zależność robisie oraz zmienić lockfile. Link manifestu (także wiszący) lub katalog odrzuca z wyjaśnieniem. Po uninstall zachowaj pozostawiony `package.json`. Gdy nie ma poprawnego klucza, wróć do Connect i ukrytego pytania init: przy istniejącym zwykłym manifeście wykonaj blok nowej instalacji od `set +x` do doctor, bez kroku `cd`/tworzenia manifestu. Nie usuwaj manifestu, żeby ponowić instalację.
|
|
53
63
|
|
|
54
64
|
<!-- reinstall:start -->
|
|
55
65
|
```sh
|
|
@@ -89,16 +99,18 @@ Dla Codex lub OpenCode zastąp `claude` przez `codex` lub `opencode`. Sam `--age
|
|
|
89
99
|
|
|
90
100
|
## Po init — sprawdź gotowość CEO
|
|
91
101
|
|
|
92
|
-
Po Connect, init i wczytaniu klucza według bloku powyżej uruchom `npx robisie doctor`.
|
|
102
|
+
Po Connect, init i wczytaniu klucza według bloku powyżej uruchom `npx robisie doctor`. Odczyt projektów to odczyt aktywnych projektów przez `list_projects`. Nie wymaga wpisywania UUID. Sam `init` z exit 0 ani „połączono” nie wystarczają do potwierdzenia gotowości CEO.
|
|
93
103
|
|
|
94
104
|
- **0 projektów, exit 1:** `CEO wymaga dokładnie 1 projektu (projektów: 0).` Następny krok: `Sprawdź gotowość projektu na https://robisie.app/dashboard/plugins/planer.` Wróć do przygotowania projektu opisanego przed init.
|
|
95
|
-
- **Więcej niż 1 projekt, exit 1** (np. `CEO wymaga dokładnie 1 projektu (projektów: 2).`):
|
|
105
|
+
- **Więcej niż 1 projekt, exit 1** (np. `CEO wymaga dokładnie 1 projektu (projektów: 2).`): Uporządkuj widoczność projektów w `list_projects` do 1; sam wybór projektu w panelu nie zmienia wyniku `list_projects`. Człowiek sam decyduje, który projekt zachować aktywny; przy pozostałych na liście wybiera „Archiwizuj”. „Archiwum” → „Przywróć” cofa archiwizację. Nie usuwaj projektów. Kliknięcie projektu nie zawęża wyniku `list_projects`.
|
|
96
106
|
- **1 projekt:** oczekuj dokładnie `✓ Połączenie działa: klucz otwiera tablicę (projektów: 1).` oraz końcowego `Wszystko działa. Uruchom swojego agenta i poproś o rolę robisie CEO.` i exit 0.
|
|
97
107
|
|
|
98
108
|
Po zmianie ponów `npx robisie doctor`. Rozwiąż też inne błędy doctor: sam licznik 1 nie wystarcza bez końcowego komunikatu sukcesu i exit 0.
|
|
99
109
|
|
|
100
110
|
Po sukcesie człowiek potwierdza nazwę i cel projektu oraz katalog instalacji, bez klucza i UUID. Przejdź do startu CEO poniżej; to nie jest odbiór karty.
|
|
101
111
|
|
|
112
|
+
Przykład pierwszej karty: w katalogu instalacji utwórz tylko `wynik.txt` z treścią „robisie działa” i końcowym znakiem nowej linii; sprawdź dokładną treść odczytem, bez zależności i publikacji.
|
|
113
|
+
|
|
102
114
|
## Start CEO
|
|
103
115
|
|
|
104
116
|
Człowiek uruchamia CEO w katalogu instalacji.
|
|
@@ -113,12 +125,25 @@ W Claude Code CEO uruchamia niezależnego Quality Officera przez `Agent(quality-
|
|
|
113
125
|
|
|
114
126
|
OpenCode: karta pozostaje w `in_review` niezależnie od dostępności narzędzia Agent; brak wspieranego przejścia do `delivered`. Pełny odbiór wymaga opisanej w przewodnikach drogi Claude Code.
|
|
115
127
|
|
|
116
|
-
Codex: przejście do delivered wymaga niezależnej recenzji oraz zweryfikowanego potwierdzenia (verified receipt). Jeśli w sesji CEO brakuje narzędzia Agent, karta pozostaje w `in_review` i wymaga naprawy integracji przez CEO
|
|
128
|
+
Codex: przejście do delivered wymaga niezależnej recenzji oraz zweryfikowanego potwierdzenia (verified receipt). Jeśli w sesji CEO brakuje narzędzia Agent, karta pozostaje w `in_review` i wymaga naprawy integracji przez osobę odpowiedzialną za integrację CEO.
|
|
117
129
|
|
|
118
130
|
Wszystkie trzy role muszą używać jednego dostawcy; mieszana mapa daje kod 1 doctor. Paczka nie uruchamia usług w tle ani nie zapewnia konta lub dostępu do AI.
|
|
119
131
|
|
|
132
|
+
### Aktualizacja przed pierwszym init
|
|
133
|
+
|
|
134
|
+
W przygotowanym katalogu instalacji, przed pierwszym init, aktualizacja samej paczki npm nie wymaga klucza ani `manifest.json` instalatora. Zachowaj istniejący manifest projektu; w pustym katalogu utwórz najpierw lokalny `package.json` samym krokiem Node powyżej. Następnie wykonaj jedną linię; do wybranego przepisu init przejdź, gdy konto i klucz będą gotowe.
|
|
135
|
+
|
|
136
|
+
<!-- before-init-update:start -->
|
|
137
|
+
```sh
|
|
138
|
+
npm i robisie@latest
|
|
139
|
+
```
|
|
140
|
+
<!-- before-init-update:end -->
|
|
141
|
+
|
|
142
|
+
### Aktualizacja po init
|
|
143
|
+
|
|
120
144
|
Aktualizuj w katalogu instalacji po prywatnej kopii opisanej w przewodnikach. Init nie czyta automatycznie pliku key: pierwszeństwo ma ROBISIE_KEY, potem ukryte pytanie, potem jawny `--key-stdin`. Wczytaj stary klucz przed init/doctor z tym samym XDG_CONFIG_HOME, bez xtrace i bez wydruku:
|
|
121
145
|
|
|
146
|
+
<!-- update:start -->
|
|
122
147
|
```sh
|
|
123
148
|
set +x
|
|
124
149
|
{
|
|
@@ -137,6 +162,7 @@ npm i robisie@latest &&
|
|
|
137
162
|
npx robisie init &&
|
|
138
163
|
npx robisie doctor
|
|
139
164
|
```
|
|
165
|
+
<!-- update:end -->
|
|
140
166
|
|
|
141
167
|
Doctor sprawdza MAJOR kontraktu. Przy niezgodności wybierz zgodne wydanie. Poprzedni zgodny tgz przygotuj przez `npm pack robisie@<wersja>`; komenda powrotu `npm i --no-save "$backup/robisie-$previous_version.tgz"` wymaga jawnie wybranej wersji, prywatnej kopii konfiguracji i porównania późniejszych własnych zmian według przewodników. Opcja `--no-save` zachowuje przywrócone `package.json` i `package-lock.json`, bez zapisywania zależności `file:` od ścieżki prywatnej kopii. Kolejność powrotu: konfiguracja i OBA manifesty projektu (`package.json`, `package-lock.json`) → ENV starego klucza → tgz → init → doctor. To nie jest automatyczny rollback.
|
|
142
168
|
|
|
@@ -177,4 +203,4 @@ Kod 0 oznacza poprawną strukturę konfiguracji i dokładnie cztery kompletne pr
|
|
|
177
203
|
|
|
178
204
|
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.
|
|
179
205
|
|
|
180
|
-
Backupy po uninstall mogą nadal zawierać klucz; zachowaj ich prywatność i własną retencję, bez automatycznego kasowania.
|
|
206
|
+
Backupy po uninstall mogą nadal zawierać klucz; zachowaj ich prywatność i własną retencję, bez automatycznego kasowania. Jeśli README w rejestrze jest puste, użyj lokalnych przewodników w `node_modules/robisie/docs/`; naprawa rejestru i publikacja to osobny zakres wydania.
|
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.1.
|
|
3
|
+
export declare const PACKAGE_VERSION = "0.1.4";
|
|
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.1.
|
|
3
|
+
export const PACKAGE_VERSION = "0.1.4"; // 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.
|
|
@@ -5,12 +5,17 @@ async function robisieReviewGuard() {
|
|
|
5
5
|
"tool.execute.before": async (input, output) => {
|
|
6
6
|
if (typeof input !== "object" || input === null || !("tool" in input))
|
|
7
7
|
return;
|
|
8
|
-
if (input.tool !== "robisie_create_task" && input.tool !== "robisie_update_task")
|
|
8
|
+
if (input.tool !== "robisie_create_task" && input.tool !== "robisie_update_task" && input.tool !== "robisie_create_tasks")
|
|
9
9
|
return;
|
|
10
10
|
if (typeof output !== "object" || output === null || !("args" in output))
|
|
11
11
|
return;
|
|
12
12
|
const args = output.args;
|
|
13
|
-
if (typeof args
|
|
13
|
+
if (typeof args !== "object" || args === null)
|
|
14
|
+
return;
|
|
15
|
+
const delivered = input.tool === "robisie_create_tasks"
|
|
16
|
+
? "tasks" in args && Array.isArray(args.tasks) && args.tasks.some((task) => typeof task === "object" && task !== null && "status" in task && (task.status === "delivered" || task.status === "wdrożone"))
|
|
17
|
+
: "status" in args && (args.status === "delivered" || args.status === "wdrożone");
|
|
18
|
+
if (delivered) {
|
|
14
19
|
throw new Error("Brak wspieranego protokołu recenzji w OpenCode. Ta próba nie zmieniła karty.");
|
|
15
20
|
}
|
|
16
21
|
},
|
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.1.
|
|
20
|
+
export declare const MANAGED_LINE = "<!-- robisie:managed 0.1.4 \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;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export type SeedPackage = Readonly<{
|
|
2
|
+
scope: string;
|
|
3
|
+
spec: string;
|
|
4
|
+
brief: string;
|
|
5
|
+
}>;
|
|
6
|
+
export declare function embeddedDetails(card: Readonly<{
|
|
7
|
+
details: unknown;
|
|
8
|
+
}>, seedPackage: SeedPackage): Record<string, unknown>;
|
|
9
|
+
export declare function readbackMismatches(details: unknown, seedPackage: SeedPackage): string[];
|
|
10
|
+
export declare function parseSeedPackage(raw: string): SeedPackage;
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
function isRecord(value) {
|
|
3
|
+
return value !== null && typeof value === "object" && !Array.isArray(value);
|
|
4
|
+
}
|
|
5
|
+
function stripFence(text) {
|
|
6
|
+
let value = text.trim();
|
|
7
|
+
const opening = value.match(/^```(?:json)?\s*/i);
|
|
8
|
+
if (opening !== null)
|
|
9
|
+
value = value.slice(opening[0].length);
|
|
10
|
+
value = value.replace(/\s*```\s*$/, "");
|
|
11
|
+
return value.trim();
|
|
12
|
+
}
|
|
13
|
+
function errorText(error) {
|
|
14
|
+
return error instanceof Error ? error.message : String(error);
|
|
15
|
+
}
|
|
16
|
+
function sha256(content) {
|
|
17
|
+
return createHash("sha256").update(content, "utf8").digest("hex");
|
|
18
|
+
}
|
|
19
|
+
export function embeddedDetails(card, seedPackage) {
|
|
20
|
+
const original = isRecord(card.details) ? card.details : {};
|
|
21
|
+
return {
|
|
22
|
+
...(Object.hasOwn(original, "card_class") ? {} : { card_class: "executable" }),
|
|
23
|
+
seed_scope: seedPackage.scope,
|
|
24
|
+
seed_scope_sha256: sha256(seedPackage.scope),
|
|
25
|
+
seed_spec: seedPackage.spec,
|
|
26
|
+
seed_spec_sha256: sha256(seedPackage.spec),
|
|
27
|
+
seed_brief: seedPackage.brief,
|
|
28
|
+
seed_brief_sha256: sha256(seedPackage.brief),
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
export function readbackMismatches(details, seedPackage) {
|
|
32
|
+
if (!isRecord(details))
|
|
33
|
+
return ["details nie są obiektem"];
|
|
34
|
+
const mismatches = [];
|
|
35
|
+
for (const field of ["scope", "spec", "brief"]) {
|
|
36
|
+
const contentKey = `seed_${field}`;
|
|
37
|
+
const hashKey = `${contentKey}_sha256`;
|
|
38
|
+
const content = details[contentKey];
|
|
39
|
+
const expected = seedPackage[field];
|
|
40
|
+
if (content !== expected || typeof content !== "string" || details[hashKey] !== sha256(content)) {
|
|
41
|
+
mismatches.push(contentKey);
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
return mismatches;
|
|
45
|
+
}
|
|
46
|
+
export function parseSeedPackage(raw) {
|
|
47
|
+
let parsed;
|
|
48
|
+
try {
|
|
49
|
+
parsed = JSON.parse(stripFence(raw));
|
|
50
|
+
}
|
|
51
|
+
catch (error) {
|
|
52
|
+
throw new Error(`odpowiedź modelu nie jest JSON: ${errorText(error)}`);
|
|
53
|
+
}
|
|
54
|
+
if (!isRecord(parsed))
|
|
55
|
+
throw new Error("odpowiedź modelu nie jest obiektem");
|
|
56
|
+
for (const field of ["scope", "spec", "brief"]) {
|
|
57
|
+
if (typeof parsed[field] !== "string" || parsed[field].trim().length === 0) {
|
|
58
|
+
throw new Error(`brak niepustego pola ${field}`);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
return { scope: parsed.scope, spec: parsed.spec, brief: parsed.brief };
|
|
62
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function taskMktempEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { lstatSync, mkdtempSync, writeFileSync } from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { workerEnv } from "./worker-env.js";
|
|
4
|
+
// Only omitted templates need rewriting; explicit paths and unknown options belong to mktemp.
|
|
5
|
+
const wrapper = `#!/bin/bash
|
|
6
|
+
if [[ -z "$TMPDIR" || "$TMPDIR" != /* || ! -d "$TMPDIR" || ! -w "$TMPDIR" ]]; then
|
|
7
|
+
echo 'ACTIONABLE: brak zapisywalnego TMPDIR zadania' >&2
|
|
8
|
+
exit 1
|
|
9
|
+
fi
|
|
10
|
+
original=("$@")
|
|
11
|
+
flags=()
|
|
12
|
+
prefix=tmp
|
|
13
|
+
while getopts ':dqut:p:' flag; do
|
|
14
|
+
case "$flag" in
|
|
15
|
+
d|q|u) flags+=("-$flag") ;;
|
|
16
|
+
t) prefix="$OPTARG" ;;
|
|
17
|
+
*) exec /usr/bin/mktemp "\${original[@]}" ;;
|
|
18
|
+
esac
|
|
19
|
+
done
|
|
20
|
+
shift "$((OPTIND - 1))"
|
|
21
|
+
if (( $# > 0 )); then exec /usr/bin/mktemp "\${original[@]}"; fi
|
|
22
|
+
if [[ "$prefix" == */* ]]; then
|
|
23
|
+
echo 'mktemp: prefix must not contain a slash' >&2
|
|
24
|
+
exit 1
|
|
25
|
+
fi
|
|
26
|
+
exec /usr/bin/mktemp "\${flags[@]}" "$TMPDIR/$prefix.XXXXXXXX"
|
|
27
|
+
`;
|
|
28
|
+
export function taskMktempEnv(env) {
|
|
29
|
+
try {
|
|
30
|
+
const tmp = env.TMPDIR;
|
|
31
|
+
if (!tmp || !path.isAbsolute(tmp) || !lstatSync(tmp).isDirectory())
|
|
32
|
+
throw new Error("brak katalogu zadania");
|
|
33
|
+
const bin = mkdtempSync(path.join(tmp, "mktemp-bin-"));
|
|
34
|
+
writeFileSync(path.join(bin, "mktemp"), wrapper, { mode: 0o700, flag: "wx" });
|
|
35
|
+
return { ...workerEnv(env, tmp), PATH: `${bin}${path.delimiter}${env.PATH ?? ""}` };
|
|
36
|
+
}
|
|
37
|
+
catch (error) {
|
|
38
|
+
throw new Error(`ACTIONABLE: podkładka mktemp TMPDIR zadania: ${error instanceof Error ? error.message : String(error)}`);
|
|
39
|
+
}
|
|
40
|
+
}
|
package/docs/README.en.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# robisie — from account to accepted card (package 0.1.
|
|
1
|
+
# robisie — from account to accepted card (package 0.1.4)
|
|
2
2
|
|
|
3
3
|
Polski: [README.md](README.md).
|
|
4
4
|
|
|
@@ -9,7 +9,7 @@ An account and key are needed for init and the roles. Offline configuration vali
|
|
|
9
9
|
|
|
10
10
|
Install robisie from npm in the prepared directory; run subsequent commands and agent sessions there. [Preparation](#wymagania) → [account](#konto) → [key](#klucz) → [installation](#instalacja) → [acceptance](#recenzja-i-odbior).
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
If the registry README is empty, use the guides shipped locally at `node_modules/robisie/docs/`. Registry metadata and publication require separate release work.
|
|
13
13
|
|
|
14
14
|
<!-- sekcja: wymagania -->
|
|
15
15
|
<a id="wymagania"></a>
|
|
@@ -25,13 +25,19 @@ Prepare an empty directory on disk. You do not need a website or your own `packa
|
|
|
25
25
|
|
|
26
26
|
The human signs in at https://robisie.app with Google or an email link. Wait for the first project's readiness screen. If readiness is missing, use the fallback link to https://robisie.app/dashboard/plugins/planer and prepare a project in the dashboard; the bounded readiness checks are not a provisioning time guarantee.
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
Project lookup is the authenticated read of active projects through `list_projects`; the key scopes what the agent sees. The CEO requires authenticated `list_projects` to return exactly one project. A dashboard project is not a directory on disk: confirm with the CEO that both concern the same goal before work. With zero projects, the human checks readiness and the dashboard fallback; with several, the human must organize/archive extras until `list_projects` returns one. Clicking a project does not bind it for the CEO. Do not supply a project UUID in chat; the CEO takes its identifier only from `list_projects`. Result: one recognized project before any agent write.
|
|
29
29
|
|
|
30
30
|
<!-- sekcja: klucz -->
|
|
31
31
|
<a id="klucz"></a>
|
|
32
32
|
## Key in Connect
|
|
33
33
|
|
|
34
|
-
|
|
34
|
+
<!-- agent-consent:start -->
|
|
35
|
+
### Agent instructions — one authorization for the flow
|
|
36
|
+
|
|
37
|
+
At the start, ask once for authorization for a named flow and its boundaries: your own account, permission to generate a key, secure local storage of the key, init and the first agreed card (goal, directory, write scope and result criteria). The first-card example below covers only `wynik.txt`; agree on it with the owner before asking for authorization.
|
|
38
|
+
|
|
39
|
+
If the owner has already authorized this flow, do not ask again at those steps; continue within the agreed boundaries. A missing authorization, null, empty or unclear answer or scope change requires a question before the dependent step; continue independent authorized work. Respect a refusal: do not perform the refused steps. Authorization does not bypass protected human or provider confirmations; continue after confirmation. Keep the key out of chat, cards, arguments and command history; if secure storage or transfer is unavailable, the human uses init's hidden prompt. Someone else's open session gives no access to their account. Independent review and separate final acceptance of the result by the owner are still required.
|
|
40
|
+
<!-- agent-consent:end -->
|
|
35
41
|
|
|
36
42
|
At https://robisie.app/dashboard/connect the human selects `worker` and a recognizable label, such as “tester laptop”, then generates the key. It is shown only once: store it like a password. The human supplies it outside chat to init's hidden prompt, never to chat, a card, a command argument or shell history.
|
|
37
43
|
|
|
@@ -43,14 +49,18 @@ The package stores **one key for CEO, Builder and Quality Officer** as `ROBISIE_
|
|
|
43
49
|
<a id="instalacja"></a>
|
|
44
50
|
## Install from npm
|
|
45
51
|
|
|
46
|
-
|
|
52
|
+
All three installer roles use one provider: CEO (`ceo`), Builder (`builder`), Quality Officer (`quality`). Mixed assignments do not route execution across providers and doctor returns exit 1. For Claude, use the full assignment `npx robisie init --agent claude --role ceo=claude --role builder=claude --role quality=claude` in place of the init line below. For Codex/OpenCode, replace every `claude` with `codex`/`opencode`; `--agent` alone does not clear an earlier map.
|
|
53
|
+
|
|
54
|
+
The installer settings `ceo`/`builder`/`quality` (CEO/Builder/Quality Officer) are separate from the execution registry `roleRegistry`: `worker-client`, `lead-client`, `reviewer-client`, `tester-client`. Project names `coordinator`/`owner`/`planner`/`advisor` are another setting. There is no automatic conversion between these settings; the registry does not enable mixed installer-role execution.
|
|
55
|
+
|
|
56
|
+
After preparing the account and key, the human opens a terminal and enters the chosen empty directory (replace the example path below). The Node.js step below creates a local `package.json` regardless of the directory name, including spaces and Polish characters. The manifest sets the installation directory even under an ancestor containing `node_modules`. If the `package.json` path already exists (including a symlink), the step refuses to write; it never overwrites it. Failure to enter the directory or create the manifest stops the rest of the block. Then: install, init with the hidden key prompt, doctor. In zsh/bash clear stale ENV before init and load the saved key before doctor — init cannot set its parent environment:
|
|
47
57
|
|
|
48
58
|
```sh
|
|
49
59
|
cd "/path/to/empty directory" &&
|
|
50
60
|
node -e 'try {
|
|
51
61
|
require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
|
|
52
62
|
} catch (error) {
|
|
53
|
-
console.error(
|
|
63
|
+
console.error("Cannot create package.json; it may already exist or the path may be inaccessible. Next step: preserve the path and use the existing-project/reinstallation instructions below; resolve links/directories or access errors locally before retrying.");
|
|
54
64
|
process.exit(1);
|
|
55
65
|
}' &&
|
|
56
66
|
{
|
|
@@ -76,7 +86,7 @@ npx robisie doctor
|
|
|
76
86
|
|
|
77
87
|
The `&&` chain stops the block at the first error; assigning the key separately before `export` preserves the read status so doctor cannot mask it. After resolving the cause, retry the failed step and every subsequent step from the block in the same directory. If the manifest was already created, do not repeat its creation or delete it.
|
|
78
88
|
|
|
79
|
-
For an existing project without `package.json`, run the fresh-install block above in that project directory: it creates only a private manifest and preserves other project files. If a regular manifest already exists, or you are reinstalling with a retained valid key, use the block below in the chosen project directory. It loads the saved key before npm/init/doctor, does not overwrite a regular manifest during preparation, and creates one with `wx` only if absent. npm itself may then add the robisie dependency and change the lockfile. It refuses a manifest link (including a dangling link) or directory with an explanation. After uninstall
|
|
89
|
+
For an existing project without `package.json`, run the fresh-install block above in that project directory: it creates only a private manifest and preserves other project files. If a regular manifest already exists, or you are reinstalling with a retained valid key, use the block below in the chosen project directory. It loads the saved key before npm/init/doctor, does not overwrite a regular manifest during preparation, and creates one with `wx` only if absent. npm itself may then add the robisie dependency and change the lockfile. It refuses a manifest link (including a dangling link) or directory with an explanation. After uninstall preserve the retained `package.json`. When no valid key remains, return to Connect and the hidden init prompt: for an existing regular manifest run the fresh-install block from `set +x` through doctor, without its `cd`/manifest creation step. Do not delete a manifest to repeat installation.
|
|
80
90
|
|
|
81
91
|
<!-- reinstall:start -->
|
|
82
92
|
```sh
|
|
@@ -188,9 +198,9 @@ Doctor runs the helper file via node, the agent via npx. `ROBISIE_PROJECT_CONTEX
|
|
|
188
198
|
<!-- sekcja: pierwsza-karta -->
|
|
189
199
|
## First card and Builder startup
|
|
190
200
|
|
|
191
|
-
The human starts the CEO in the installation directory: `claude --agent ceo-client`, or `codex` and requests the robisie CEO role (reading the full file referenced by AGENTS.md), or `opencode` and selects `ceo-client`. After successful
|
|
201
|
+
The human starts the CEO in the installation directory: `claude --agent ceo-client`, or `codex` and requests the robisie CEO role (reading the full file referenced by AGENTS.md), or `opencode` and selects `ceo-client`. After a successful project lookup use this request, which works after npm installation with just README:
|
|
192
202
|
|
|
193
|
-
> Create wynik.txt in this directory with exactly “robisie działa” followed by a newline. Read it back and verify the exact contents. Boundaries: this file only, no dependencies, accounts or publication.
|
|
203
|
+
> Create wynik.txt in this directory with exactly “robisie działa” followed by a newline. Read it back and verify the exact contents. Boundaries: this file only, no dependencies, accounts or publication. Use my existing authorization if it covers this exact scope; otherwise ask before work. After the work I need independent review and separate final acceptance.
|
|
194
204
|
|
|
195
205
|
After human approval, the CEO by default calls `spawn_builder` with the ID of the card confirmed in `ready`. The full flow in Claude Code is: `draft` → `ready` → `in_progress` → `in_review` → independent review and verified receipt → `delivered` → owner acceptance → `done`; see [Review and explicit acceptance](#recenzja-i-odbior) for acceptance limits in other sessions.
|
|
196
206
|
|
|
@@ -216,13 +226,25 @@ In Claude Code, the CEO starts an independent Quality Officer through `Agent(qua
|
|
|
216
226
|
|
|
217
227
|
OpenCode: the card stays in `in_review` regardless of the availability of the Agent tool; there is no supported transition to `delivered`. Full acceptance requires the Claude Code route described above. A task/VERIFIED result, role label or receipt JSON alone does not open this transition; do not bypass a refusal with a manual status change or self-review.
|
|
218
228
|
|
|
219
|
-
In other CEO sessions, including Codex, moving to delivered requires independent review and a verified receipt. If the CEO session lacks the Agent tool, the card stays in `in_review`: this is a product capability gap for CEO
|
|
229
|
+
In other CEO sessions, including Codex, moving to delivered requires independent review and a verified receipt. If the CEO session lacks the Agent tool, the card stays in `in_review`: this is a product capability gap for the person responsible for the CEO integration to resolve. Do not substitute Builder self-review or a manual status change. Installing three roles does not provide that integration.
|
|
220
230
|
|
|
221
231
|
The project owner can use Dashboard → Planer → card → Etap → “Zrobione” to move `delivered` to `done`, including when the agent uses a `worker` key. For the first card described here, the server does not enforce stored acceptance or evidence before a change to `done`: the dashboard lets the owner select “Zrobione” even without them. Do this only after checking and explicitly accepting the result. The dashboard cannot edit `details`; review and evidence are recorded through the supported board tool flow. This guide alone does not prove a customer has completed that flow.
|
|
222
232
|
|
|
223
233
|
<!-- sekcja: aktualizacja -->
|
|
224
234
|
## Update and private backup
|
|
225
235
|
|
|
236
|
+
### Update before the first init
|
|
237
|
+
|
|
238
|
+
In the prepared installation directory, before the first init, updating the npm package needs neither a key nor the installer's `manifest.json`. Preserve an existing project manifest; for an empty directory first create the local `package.json` using only the Node step above. Then run this one line; continue with the chosen init recipe when the account and key are ready.
|
|
239
|
+
|
|
240
|
+
<!-- before-init-update:start -->
|
|
241
|
+
```sh
|
|
242
|
+
npm i robisie@latest
|
|
243
|
+
```
|
|
244
|
+
<!-- before-init-update:end -->
|
|
245
|
+
|
|
246
|
+
### Update after init
|
|
247
|
+
|
|
226
248
|
Work in the installation directory. First prepare the backup below. Explicitly choose the previous release compatible with the server contract MAJOR; inspect the installed version with `node -p 'require("./node_modules/robisie/package.json").version'`. Replace the example `previous_version='0.1.1'` with that chosen version. `npm pack robisie@<wersja>` means pack the explicitly selected release, not an arbitrary tgz. Retain its filename and the backup directory. Disable xtrace; never print or paste secrets.
|
|
227
249
|
|
|
228
250
|
```sh
|
|
@@ -242,39 +264,66 @@ Keep the installation's HOME, XDG_CONFIG_HOME and CODEX_HOME values (the command
|
|
|
242
264
|
|
|
243
265
|
Missing/null/empty/malformed project configuration or installation record cannot guarantee restore. Preserve available data, run local `npx robisie doctor` and follow its advice; new init cannot reconstruct a missing record. Resolve record or key-read errors before network errors. Never replace a damaged record with an empty one.
|
|
244
266
|
|
|
245
|
-
Follow four steps; the
|
|
267
|
+
Follow four steps; the command pairs below are a reference for selecting files, not twenty mandatory copies:
|
|
246
268
|
|
|
247
269
|
1. Preserve project manifests (`package.json` and `package-lock.json`), project configuration and robisie’s installation record/key. Record absent files in `absent.txt`.
|
|
248
270
|
2. From `manifest.entries`, select only installed providers, the recorded profile, roles and prior backups. Apply all path, type and readability checks below.
|
|
249
271
|
3. Make and check only those copies; retain their paths and the selected release tgz privately.
|
|
250
272
|
4. Update only after the copies are complete. To restore, compare later changes and restore BOTH project manifests before the tgz command, then load the key → install tgz → init → doctor.
|
|
251
273
|
|
|
252
|
-
The
|
|
253
|
-
|
|
254
|
-
Set `profile` to the profile actually changed in manifest.entries: zsh `${ZDOTDIR:-$HOME}/.zshrc`; bash on macOS the first readable `$HOME/.bash_profile`, `$HOME/.bash_login`, `$HOME/.profile` (fallback `.bash_profile`); bash elsewhere `$HOME/.bashrc`. With `--no-shell`/another shell do not invent a profile; still preserve a prior profile entry if recorded. For each additional `path` and `backup` in entries, set `entry_path` to the exact absolute path, choose a unique numeric `entry_id`, and record that pair privately. Repeat the
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
274
|
+
The blocks below contain separate commands for manual selection, not a block to run wholesale. Copy project and robisie files and only the providers used in the record, never all of `~/.claude/`, CODEX_HOME or the OpenCode directory. Before each command check the type and readability of source, destination and their ancestors. For `backups/` and `roles/codex/`, inspect every child as well. An unreadable file/entry or a symlink (including dangling links and linked ancestors) stops the recipe: preserve state and compare paths, never blindly cp through a link. A directory where a file is expected also needs investigation. If a file is absent, record its full path in `$backup/absent.txt`, e.g. `printf '%s\n' "$PWD/robisie.config.json" >> "$backup/absent.txt"`; skip cp in both directions. Do not delete files created later during restore.
|
|
275
|
+
|
|
276
|
+
Set `profile` to the profile actually changed in manifest.entries: zsh `${ZDOTDIR:-$HOME}/.zshrc`; bash on macOS the first readable `$HOME/.bash_profile`, `$HOME/.bash_login`, `$HOME/.profile` (fallback `.bash_profile`); bash elsewhere `$HOME/.bashrc`. With `--no-shell`/another shell do not invent a profile; still preserve a prior profile entry if recorded. For each additional `path` and `backup` in entries, set `entry_path` to the exact absolute path, choose a unique numeric `entry_id`, and record that pair privately. Repeat the entry_path pair for every such file. Do not assume defaults cover prior installations or providers. Create only needed missing destination directories after the same path checks.
|
|
277
|
+
|
|
278
|
+
Copy: select only the required commands, checking each result.
|
|
279
|
+
|
|
280
|
+
```sh
|
|
281
|
+
cp -p -- "$PWD/package.json" "$backup/project/package.json"
|
|
282
|
+
cp -p -- "$PWD/package-lock.json" "$backup/project/package-lock.json"
|
|
283
|
+
cp -p -- "$PWD/robisie.config.json" "$backup/project/robisie.config.json"
|
|
284
|
+
cp -p -- "$config_home/robisie/key" "$backup/robisie/key"
|
|
285
|
+
cp -p -- "$config_home/robisie/manifest.json" "$backup/robisie/manifest.json"
|
|
286
|
+
cp -Rp -- "$config_home/robisie/backups/." "$backup/robisie/backups/"
|
|
287
|
+
cp -Rp -- "$config_home/robisie/roles/codex/." "$backup/robisie/roles/codex/"
|
|
288
|
+
cp -p -- "$HOME/.claude.json" "$backup/claude/claude.json"
|
|
289
|
+
cp -p -- "$HOME/.claude/agents/ceo-client.md" "$backup/claude/agents/ceo-client.md"
|
|
290
|
+
cp -p -- "$HOME/.claude/agents/manager-builder-client.md" "$backup/claude/agents/manager-builder-client.md"
|
|
291
|
+
cp -p -- "$HOME/.claude/agents/quality-officer-client.md" "$backup/claude/agents/quality-officer-client.md"
|
|
292
|
+
cp -p -- "$codex_home/config.toml" "$backup/codex/config.toml"
|
|
293
|
+
cp -p -- "$codex_home/AGENTS.md" "$backup/codex/AGENTS.md"
|
|
294
|
+
cp -p -- "$config_home/opencode/opencode.json" "$backup/opencode/opencode.json"
|
|
295
|
+
cp -p -- "$config_home/opencode/agents/ceo-client.md" "$backup/opencode/agents/ceo-client.md"
|
|
296
|
+
cp -p -- "$config_home/opencode/agents/manager-builder-client.md" "$backup/opencode/agents/manager-builder-client.md"
|
|
297
|
+
cp -p -- "$config_home/opencode/agents/quality-officer-client.md" "$backup/opencode/agents/quality-officer-client.md"
|
|
298
|
+
cp -p -- "$config_home/opencode/plugins/robisie-review-guard.js" "$backup/opencode/plugins/robisie-review-guard.js"
|
|
299
|
+
cp -p -- "$profile" "$backup/profile/selected"
|
|
300
|
+
cp -p -- "$entry_path" "$backup/entries/$entry_id"
|
|
301
|
+
```
|
|
302
|
+
|
|
303
|
+
Restore: the same source/copy pairs in the same order, only after comparison.
|
|
304
|
+
|
|
305
|
+
```sh
|
|
306
|
+
cp -p -- "$backup/project/package.json" "$PWD/package.json"
|
|
307
|
+
cp -p -- "$backup/project/package-lock.json" "$PWD/package-lock.json"
|
|
308
|
+
cp -p -- "$backup/project/robisie.config.json" "$PWD/robisie.config.json"
|
|
309
|
+
cp -p -- "$backup/robisie/key" "$config_home/robisie/key"
|
|
310
|
+
cp -p -- "$backup/robisie/manifest.json" "$config_home/robisie/manifest.json"
|
|
311
|
+
cp -Rp -- "$backup/robisie/backups/." "$config_home/robisie/backups/"
|
|
312
|
+
cp -Rp -- "$backup/robisie/roles/codex/." "$config_home/robisie/roles/codex/"
|
|
313
|
+
cp -p -- "$backup/claude/claude.json" "$HOME/.claude.json"
|
|
314
|
+
cp -p -- "$backup/claude/agents/ceo-client.md" "$HOME/.claude/agents/ceo-client.md"
|
|
315
|
+
cp -p -- "$backup/claude/agents/manager-builder-client.md" "$HOME/.claude/agents/manager-builder-client.md"
|
|
316
|
+
cp -p -- "$backup/claude/agents/quality-officer-client.md" "$HOME/.claude/agents/quality-officer-client.md"
|
|
317
|
+
cp -p -- "$backup/codex/config.toml" "$codex_home/config.toml"
|
|
318
|
+
cp -p -- "$backup/codex/AGENTS.md" "$codex_home/AGENTS.md"
|
|
319
|
+
cp -p -- "$backup/opencode/opencode.json" "$config_home/opencode/opencode.json"
|
|
320
|
+
cp -p -- "$backup/opencode/agents/ceo-client.md" "$config_home/opencode/agents/ceo-client.md"
|
|
321
|
+
cp -p -- "$backup/opencode/agents/manager-builder-client.md" "$config_home/opencode/agents/manager-builder-client.md"
|
|
322
|
+
cp -p -- "$backup/opencode/agents/quality-officer-client.md" "$config_home/opencode/agents/quality-officer-client.md"
|
|
323
|
+
cp -p -- "$backup/opencode/plugins/robisie-review-guard.js" "$config_home/opencode/plugins/robisie-review-guard.js"
|
|
324
|
+
cp -p -- "$backup/profile/selected" "$profile"
|
|
325
|
+
cp -p -- "$backup/entries/$entry_id" "$entry_path"
|
|
326
|
+
```
|
|
278
327
|
|
|
279
328
|
Once the tgz and selected copies are ready, update. Init does not read the key file automatically: ROBISIE_KEY takes priority, then the hidden terminal prompt, then explicit `--key-stdin` (for example automation without a terminal). A key file alone is insufficient. Load the old key BEFORE init/doctor using the same XDG_CONFIG_HOME; separate assignment before export and `&&` retain read failures without printing the key:
|
|
280
329
|
|
|
@@ -305,9 +354,9 @@ Doctor checks the contract MAJOR; exit 0 also requires its other checks. Choose
|
|
|
305
354
|
|
|
306
355
|
### Return to the previous release
|
|
307
356
|
|
|
308
|
-
Before overwriting, preserve later user edits in a NEW private copy (`umask 077`, e.g. `later="$(mktemp -d "$HOME/robisie-later.XXXXXX")"`). Repeat directory preparation and the
|
|
357
|
+
Before overwriting, preserve later user edits in a NEW private copy (`umask 077`, e.g. `later="$(mktemp -d "$HOME/robisie-later.XXXXXX")"`). Repeat directory preparation and the copy block, substituting `$later` for `$backup`, without altering the original backup. Compare locally and merge user edits with the previous release's copy; configuration can contain a key, so do not publish the diff. Stop overwriting for unreadable configuration, links or an unresolved comparison. There is no promise of automatic rollback.
|
|
309
358
|
|
|
310
|
-
After comparison run the selected
|
|
359
|
+
After comparison run the selected restore-block commands to the same destinations, honoring absent.txt. Directory commands copy contents through `/.` without nesting another directory; before restore prepare checked destination directories if missing. When merging `backups/` and `roles/codex/`, do not delete additional later files. Restore `package.json` AND `package-lock.json` first. Then in the same cwd load the restored old key into ENV, install the retained compatible tgz, and only then run init and doctor:
|
|
311
360
|
|
|
312
361
|
<!-- restore:start -->
|
|
313
362
|
```sh
|
|
@@ -334,7 +383,7 @@ npx robisie doctor
|
|
|
334
383
|
|
|
335
384
|
The `--no-save` option preserves the restored `package.json` and `package-lock.json` without recording a `file:` dependency on the private backup path.
|
|
336
385
|
|
|
337
|
-
Check the status of every
|
|
386
|
+
Check the status of every separately selected command; any error stops the recipe. The chain stops automatically. Never mask reads or combine key assignment with export. On failure preserve both copies and follow doctor before further overwrites.
|
|
338
387
|
|
|
339
388
|
<!-- sekcja: odinstalowanie -->
|
|
340
389
|
## Uninstall
|
|
@@ -355,17 +404,24 @@ Without an installation, begin with the account and Connect → init; repeating
|
|
|
355
404
|
|
|
356
405
|
CLI messages remain in Polish. Match the message, then follow the English explanation:
|
|
357
406
|
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
407
|
+
- **brak-klucza** — `Brak klucza robisie.`
|
|
408
|
+
No key: generate one in Connect and supply it to init.
|
|
409
|
+
- **odrzucony-klucz** — `Serwer robisie odrzucił klucz (nieważny albo unieważniony).`
|
|
410
|
+
Generate a new worker key; in zsh/bash run `unset ROBISIE_KEY`, then init with the hidden prompt.
|
|
411
|
+
- **brak-odczytu** — `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).`
|
|
412
|
+
Select worker in Connect; `unset ROBISIE_KEY`, then init with the hidden prompt.
|
|
413
|
+
- **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.1.4 (obsługuje 1.x).`
|
|
414
|
+
Example of a MAJOR mismatch: install a release compatible with the server contract.
|
|
415
|
+
- **brak-env** — `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.`
|
|
416
|
+
Check profile support; with --no-shell/another shell load the key file into the session environment as shown in init, then doctor.
|
|
417
|
+
- **brak-programu** — `katalog jest, programu nie ma w PATH`
|
|
418
|
+
Install the named provider program or add it to PATH; a configuration directory alone is insufficient.
|
|
419
|
+
- **brak-programu-i-katalogu** — `brak programu w PATH i katalogu dostawcy`
|
|
420
|
+
Install the selected program, repeat init with the complete shared map and doctor.
|
|
421
|
+
- **jsonc** — `nie zmieniam automatycznie`
|
|
422
|
+
Preserve JSONC; prepare supported JSON or choose another provider for all roles. Remote MCP alone is insufficient.
|
|
423
|
+
- **niepelna-instalacja** — `Claude Code: niepełna instalacja`
|
|
424
|
+
Example of missing configuration: repeat init for your agent.
|
|
369
425
|
|
|
370
426
|
After repair with an existing record, load the saved key as shown in Update before local `npx robisie init` and `npx robisie doctor`; reinstall missing package files from npm, and obtain a compatible release for MAJOR. For a missing record preserve data and follow doctor instead of blindly running init. If the problem remains, send the team the message, version and cwd without the key. Uninstall success means removed entries and exit 0; exit 1 needs the indicated repair and does not mean complete removal.
|
|
371
427
|
|
package/docs/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# robisie — od konta do odebranej karty (paczka 0.1.
|
|
1
|
+
# robisie — od konta do odebranej karty (paczka 0.1.4)
|
|
2
2
|
|
|
3
3
|
English: [README.en.md](README.en.md).
|
|
4
4
|
|
|
@@ -11,7 +11,7 @@ Konto i klucz są potrzebne do init i pracy ról. Osobne wejście to walidacja o
|
|
|
11
11
|
|
|
12
12
|
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
13
|
|
|
14
|
-
|
|
14
|
+
Jeśli README w rejestrze jest puste, użyj lokalnych przewodników w `node_modules/robisie/docs/`. Metadane rejestru i publikacja wymagają osobnej pracy wydaniowej.
|
|
15
15
|
|
|
16
16
|
<!-- sekcja: wymagania -->
|
|
17
17
|
<a id="wymagania"></a>
|
|
@@ -27,13 +27,19 @@ Przygotuj pusty katalog na dysku. Nie potrzebujesz strony ani własnego pliku `p
|
|
|
27
27
|
|
|
28
28
|
Człowiek loguje się na https://robisie.app przez Google albo link e-mail. Zaczekaj na ekran gotowości pierwszego projektu. Przy braku gotowości użyj odnośnika do https://robisie.app/dashboard/plugins/planer i przygotuj projekt w panelu; liczba prób sprawdzania gotowości nie jest gwarancją czasu przygotowania.
|
|
29
29
|
|
|
30
|
-
|
|
30
|
+
Odczyt projektów to uwierzytelniony odczyt aktywnych projektów przez `list_projects`; klucz wyznacza, co agent widzi. CEO wymaga, aby uwierzytelnione `list_projects` zwróciło dokładnie jeden projekt. Projekt w panelu nie jest katalogiem na dysku: przed pracą potwierdź z CEO, że dotyczą tego samego celu. Przy zerze projektów człowiek sprawdza gotowość i fallback panelu; przy wielu porządkuje/archiwizuje nadmiarowe projekty, aż `list_projects` zwróci jeden. Wybór kliknięciem w panelu nie wiąże projektu dla CEO. Nie podawaj UUID projektu w rozmowie; CEO bierze identyfikator wyłącznie z `list_projects`. Wynik: jeden rozpoznany projekt, zanim agent zapisze cokolwiek.
|
|
31
31
|
|
|
32
32
|
<!-- sekcja: klucz -->
|
|
33
33
|
<a id="klucz"></a>
|
|
34
34
|
## Klucz w Connect
|
|
35
35
|
|
|
36
|
-
|
|
36
|
+
<!-- agent-consent:start -->
|
|
37
|
+
### Instrukcja dla agenta — jedna zgoda na przebieg
|
|
38
|
+
|
|
39
|
+
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). Przykład pierwszej karty poniżej obejmuje tylko `wynik.txt`; wybierz ją z właścicielem przed prośbą o zgodę.
|
|
40
|
+
|
|
41
|
+
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.
|
|
42
|
+
<!-- agent-consent:end -->
|
|
37
43
|
|
|
38
44
|
Człowiek w https://robisie.app/dashboard/connect wybiera `worker` i własną rozpoznawalną etykietę, np. „tester laptop”, następnie generuje klucz. Jest wyświetlany tylko raz: zachowaj go jak hasło. Człowiek przekazuje go poza rozmową do ukrytego pytania init, nigdy do czatu, karty, argumentu polecenia ani historii powłoki.
|
|
39
45
|
|
|
@@ -45,14 +51,18 @@ Paczka zapisuje **jeden klucz dla CEO, Buildera i Quality Officera** jako `ROBIS
|
|
|
45
51
|
<a id="instalacja"></a>
|
|
46
52
|
## Instalacja z npm
|
|
47
53
|
|
|
48
|
-
|
|
54
|
+
Trzy role instalatora używają jednego dostawcy: CEO (`ceo`), Builder (`builder`), Quality Officer (`quality`). Mieszana mapa nie uruchamia ról między dostawcami, a doctor zwraca kod 1. Dla Claude użyj pełnego przypisania `npx robisie init --agent claude --role ceo=claude --role builder=claude --role quality=claude` zamiast linii init poniżej. Dla Codex/OpenCode zastąp każde `claude` przez `codex`/`opencode`; samo `--agent` nie kasuje wcześniejszej mapy.
|
|
55
|
+
|
|
56
|
+
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.
|
|
57
|
+
|
|
58
|
+
Po przygotowaniu konta i klucza człowiek otwiera terminal i wchodzi do wybranego pustego katalogu (zastąp przykładową ścieżkę poniżej). Poniższy krok Node.js tworzy lokalny `package.json` niezależnie od nazwy katalogu, także ze spacjami i polskimi znakami. Manifest ustala katalog instalacji także pod przodkiem z `node_modules`. Jeśli ścieżka `package.json` już istnieje (również jako link), krok odmawia zapisu; niczego nie nadpisuje. Błąd wejścia do katalogu lub utworzenia manifestu zatrzymuje dalszy blok. Następnie: instalacja, init z ukrytym pytaniem o klucz, doctor. W zsh/bash usuń stary ENV przed init i wczytaj zapisany klucz przed doctor — init nie ustawia środowiska rodzica:
|
|
49
59
|
|
|
50
60
|
```sh
|
|
51
61
|
cd "/ścieżka/do/pustego katalogu" &&
|
|
52
62
|
node -e 'try {
|
|
53
63
|
require("node:fs").writeFileSync("package.json", "{\"private\":true}\n", { flag: "wx" });
|
|
54
64
|
} catch (error) {
|
|
55
|
-
console.error(
|
|
65
|
+
console.error("Nie można utworzyć package.json: ścieżka już istnieje albo jest niedostępna. Następny krok: zachowaj ją i przejdź do instrukcji istniejącego projektu/reinstalacji poniżej; link/katalog lub błąd dostępu wyjaśnij lokalnie przed ponowieniem.");
|
|
56
66
|
process.exit(1);
|
|
57
67
|
}' &&
|
|
58
68
|
{
|
|
@@ -78,7 +88,7 @@ npx robisie doctor
|
|
|
78
88
|
|
|
79
89
|
Łańcuch `&&` zatrzymuje blok po pierwszym błędzie; osobne przypisanie przed `export` zachowuje status odczytu klucza, więc doctor go nie maskuje. Po naprawieniu przyczyny ponów nieudany krok i wszystkie następne z bloku w tym samym katalogu. Jeśli manifest już powstał, nie ponawiaj jego tworzenia ani go nie usuwaj.
|
|
80
90
|
|
|
81
|
-
Dla istniejącego projektu bez `package.json` wykonaj powyższy blok nowej instalacji w katalogu tego projektu: tworzy tylko prywatny manifest i zachowuje pozostałe pliki. Jeśli zwykły manifest już istnieje albo reinstalujesz z zachowanym poprawnym kluczem, użyj poniższego bloku w wybranym katalogu projektu. Wczytuje zapisany klucz przed npm/init/doctor, nie nadpisuje zwykłego manifestu podczas przygotowania i tworzy go przez `wx` tylko przy braku. Samo npm może następnie dopisać zależność robisie oraz zmienić lockfile. Link manifestu (także wiszący) lub katalog odrzuca z wyjaśnieniem. Po uninstall
|
|
91
|
+
Dla istniejącego projektu bez `package.json` wykonaj powyższy blok nowej instalacji w katalogu tego projektu: tworzy tylko prywatny manifest i zachowuje pozostałe pliki. Jeśli zwykły manifest już istnieje albo reinstalujesz z zachowanym poprawnym kluczem, użyj poniższego bloku w wybranym katalogu projektu. Wczytuje zapisany klucz przed npm/init/doctor, nie nadpisuje zwykłego manifestu podczas przygotowania i tworzy go przez `wx` tylko przy braku. Samo npm może następnie dopisać zależność robisie oraz zmienić lockfile. Link manifestu (także wiszący) lub katalog odrzuca z wyjaśnieniem. Po uninstall zachowaj pozostawiony `package.json`. Gdy nie ma poprawnego klucza, wróć do Connect i ukrytego pytania init: przy istniejącym zwykłym manifeście wykonaj blok nowej instalacji od `set +x` do doctor, bez kroku `cd`/tworzenia manifestu. Nie usuwaj manifestu, żeby ponowić instalację.
|
|
82
92
|
|
|
83
93
|
<!-- reinstall:start -->
|
|
84
94
|
```sh
|
|
@@ -190,9 +200,9 @@ Doctor uruchamia plik pomocnika przez node, agent przez npx. `ROBISIE_PROJECT_CO
|
|
|
190
200
|
<!-- sekcja: pierwsza-karta -->
|
|
191
201
|
## Pierwsza karta i start Buildera
|
|
192
202
|
|
|
193
|
-
Człowiek uruchamia CEO w katalogu instalacji: `claude --agent ceo-client`, albo `codex` i prosi o rolę robisie CEO (odczyt pełnego pliku wskazanego w AGENTS.md), albo `opencode` i wybiera `ceo-client`. Po poprawnym
|
|
203
|
+
Człowiek uruchamia CEO w katalogu instalacji: `claude --agent ceo-client`, albo `codex` i prosi o rolę robisie CEO (odczyt pełnego pliku wskazanego w AGENTS.md), albo `opencode` i wybiera `ceo-client`. Po poprawnym odczycie projektów przekaż prośbę, która działa po instalacji npm z samym README:
|
|
194
204
|
|
|
195
|
-
> Utwórz w tym katalogu plik wynik.txt z dokładną treścią „robisie działa” i końcowym znakiem nowej linii. Sprawdź odczytem, że treść jest dokładnie taka. Granice: tylko ten plik, bez zależności, kont i publikacji.
|
|
205
|
+
> Utwórz w tym katalogu plik wynik.txt z dokładną treścią „robisie działa” i końcowym znakiem nowej linii. Sprawdź odczytem, że treść jest dokładnie taka. Granice: tylko ten plik, bez zależności, kont i publikacji. Korzystaj z mojej wcześniejszej zgody, jeśli obejmuje dokładnie ten zakres; w przeciwnym razie zapytaj przed pracą. Po pracy potrzebuję niezależnej recenzji i osobnego końcowego odbioru.
|
|
196
206
|
|
|
197
207
|
Po zgodzie człowieka CEO domyślnie wywołuje `spawn_builder` z ID karty potwierdzonej w `ready`. Pełny przebieg w Claude Code: `draft` → `ready` → `in_progress` → `in_review` → niezależna recenzja i verified receipt → `delivered` → odbiór właściciela → `done`; granice odbioru dla pozostałych sesji opisuje sekcja [Recenzja i jawny odbiór](#recenzja-i-odbior).
|
|
198
208
|
|
|
@@ -218,13 +228,25 @@ W Claude Code CEO uruchamia niezależnego Quality Officera przez `Agent(quality-
|
|
|
218
228
|
|
|
219
229
|
OpenCode: karta pozostaje w `in_review` niezależnie od dostępności narzędzia Agent; brak wspieranego przejścia do `delivered`. Pełny odbiór wymaga opisanej wyżej ścieżki w Claude Code. Wynik task/VERIFIED, etykieta roli ani sam JSON receiptu nie otwierają tego przejścia; nie obchodź odmowy ręczną zmianą statusu ani samorecenzją.
|
|
220
230
|
|
|
221
|
-
W innych sesjach CEO, w tym Codex, przejście do delivered wymaga niezależnej recenzji oraz zweryfikowanego potwierdzenia (verified receipt). Jeśli w sesji CEO brakuje narzędzia Agent, karta pozostaje w `in_review`: to brak zdolności produktu wymagający naprawy CEO
|
|
231
|
+
W innych sesjach CEO, w tym Codex, przejście do delivered wymaga niezależnej recenzji oraz zweryfikowanego potwierdzenia (verified receipt). Jeśli w sesji CEO brakuje narzędzia Agent, karta pozostaje w `in_review`: to brak zdolności produktu wymagający naprawy przez osobę odpowiedzialną za integrację CEO. Nie zastępuj recenzji oceną Buildera ani ręczną zmianą etapu. Sama konfiguracja trzech ról nie zapewnia tej integracji.
|
|
222
232
|
|
|
223
233
|
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.
|
|
224
234
|
|
|
225
235
|
<!-- sekcja: aktualizacja -->
|
|
226
236
|
## Aktualizacja i prywatna kopia
|
|
227
237
|
|
|
238
|
+
### Aktualizacja przed pierwszym init
|
|
239
|
+
|
|
240
|
+
W przygotowanym katalogu instalacji, przed pierwszym init, aktualizacja samej paczki npm nie wymaga klucza ani `manifest.json` instalatora. Zachowaj istniejący manifest projektu; w pustym katalogu utwórz najpierw lokalny `package.json` samym krokiem Node powyżej. Następnie wykonaj jedną linię; do wybranego przepisu init przejdź, gdy konto i klucz będą gotowe.
|
|
241
|
+
|
|
242
|
+
<!-- before-init-update:start -->
|
|
243
|
+
```sh
|
|
244
|
+
npm i robisie@latest
|
|
245
|
+
```
|
|
246
|
+
<!-- before-init-update:end -->
|
|
247
|
+
|
|
248
|
+
### Aktualizacja po init
|
|
249
|
+
|
|
228
250
|
Pracuj w katalogu instalacji. Najpierw przygotuj kopię poniżej. Wybierz jawnie poprzednią, zgodną z MAJOR kontraktu serwera wersję; sprawdź zainstalowaną przez `node -p 'require("./node_modules/robisie/package.json").version'`. Przykład `previous_version='0.1.1'` zastąp tą wybraną wersją. `npm pack robisie@<wersja>` pobiera właśnie to wydanie, nie przypadkowy plik tgz; zachowaj jego nazwę i katalog kopii. Nie wykonuj przepisu z włączonym xtrace, nie drukuj ani nie wklejaj sekretów.
|
|
229
251
|
|
|
230
252
|
```sh
|
|
@@ -244,39 +266,66 @@ Zachowaj te same wartości HOME, XDG_CONFIG_HOME i CODEX_HOME co podczas instala
|
|
|
244
266
|
|
|
245
267
|
Brak/null/pusta/wadliwa konfiguracja projektu lub ewidencja nie daje gwarancji restore. Zachowaj dostępne dane, uruchom lokalny `npx robisie doctor` i zastosuj jego poradę; nowy init nie odtworzy brakującej ewidencji. Przy błędzie ewidencji lub odczytu klucza rozwiąż go przed błędami sieci. Nie zamieniaj uszkodzonej ewidencji na pustą.
|
|
246
268
|
|
|
247
|
-
Przejdź cztery kroki;
|
|
269
|
+
Przejdź cztery kroki; pary poleceń to ściąga wyboru plików, nie dwadzieścia obowiązkowych kopii:
|
|
248
270
|
|
|
249
271
|
1. Zachowaj manifesty projektu (`package.json` i `package-lock.json`), konfigurację projektu oraz ewidencję/klucz robisie. Braki odnotuj w `absent.txt`.
|
|
250
272
|
2. Z `manifest.entries` wybierz tylko użytych dostawców, zapisany profil, role i wcześniejsze backupy. Zastosuj wszystkie kontrole ścieżek, typu i odczytu opisane poniżej.
|
|
251
273
|
3. Wykonaj i sprawdź tylko te kopie; zachowaj prywatnie ich ścieżki oraz tgz wybranego wydania.
|
|
252
274
|
4. Aktualizuj dopiero po wykonaniu kopii. Przy powrocie porównaj późniejsze zmiany i przywróć OBA manifesty projektu przed komendą tgz, potem klucz → instalacja tgz → init → doctor.
|
|
253
275
|
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
`profile` ustaw na faktycznie zmieniony profil z manifest.entries: zsh `${ZDOTDIR:-$HOME}/.zshrc`; bash na macOS pierwszy czytelny `$HOME/.bash_profile`, `$HOME/.bash_login`, `$HOME/.profile` (gdy żaden nie istnieje, `.bash_profile`); bash poza macOS `$HOME/.bashrc`. Przy `--no-shell`/innej powłoce nie dopisuj nowego profilu; zachowaj jednak wcześniejszy wpis profilu, jeśli jest w ewidencji. Każdy dodatkowy `path` i `backup` z entries skopiuj oddzielnie: ustaw `entry_path` na dokładną absolutną ścieżkę, `entry_id` na własny unikalny numer i zanotuj parę w prywatnej kopii.
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
276
|
+
Poniższe bloki to osobne komendy do ręcznego wyboru, nie blok do uruchomienia w całości. Kopiuj pliki projektu i robisie oraz tylko użytych dostawców z ewidencji, nigdy całe `~/.claude/`, `CODEX_HOME` ani katalog OpenCode. Dla każdego źródła i celu oraz ich katalogów nadrzędnych sprawdź wcześniej typ i odczyt. Dla `backups/` i `roles/codex/` sprawdź również wszystkie elementy wewnątrz. Nieczytelny plik/wpis lub dowiązanie (także wiszące, również w katalogu nadrzędnym) zatrzymuje przepis: zachowaj stan i porównaj ścieżki, bez ślepego cp przez link. Katalog w miejscu oczekiwanego pliku także wymaga wyjaśnienia. Jeśli pliku nie ma, odnotuj jego pełną ścieżkę w `$backup/absent.txt`, np. `printf '%s\n' "$PWD/robisie.config.json" >> "$backup/absent.txt"`; pomiń cp w obie strony. Przy restore nie kasuj plików, które powstały później.
|
|
277
|
+
|
|
278
|
+
`profile` ustaw na faktycznie zmieniony profil z manifest.entries: zsh `${ZDOTDIR:-$HOME}/.zshrc`; bash na macOS pierwszy czytelny `$HOME/.bash_profile`, `$HOME/.bash_login`, `$HOME/.profile` (gdy żaden nie istnieje, `.bash_profile`); bash poza macOS `$HOME/.bashrc`. Przy `--no-shell`/innej powłoce nie dopisuj nowego profilu; zachowaj jednak wcześniejszy wpis profilu, jeśli jest w ewidencji. Każdy dodatkowy `path` i `backup` z entries skopiuj oddzielnie: ustaw `entry_path` na dokładną absolutną ścieżkę, `entry_id` na własny unikalny numer i zanotuj parę w prywatnej kopii. Parę entry_path powtórz dla każdego takiego pliku. Nie zakładaj, że lista domyślna pokrywa poprzednie instalacje i dostawców. Utwórz tylko potrzebne brakujące katalogi docelowe po tej samej kontroli ścieżek.
|
|
279
|
+
|
|
280
|
+
Kopia: wybierz tylko potrzebne polecenia i sprawdź wynik każdego.
|
|
281
|
+
|
|
282
|
+
```sh
|
|
283
|
+
cp -p -- "$PWD/package.json" "$backup/project/package.json"
|
|
284
|
+
cp -p -- "$PWD/package-lock.json" "$backup/project/package-lock.json"
|
|
285
|
+
cp -p -- "$PWD/robisie.config.json" "$backup/project/robisie.config.json"
|
|
286
|
+
cp -p -- "$config_home/robisie/key" "$backup/robisie/key"
|
|
287
|
+
cp -p -- "$config_home/robisie/manifest.json" "$backup/robisie/manifest.json"
|
|
288
|
+
cp -Rp -- "$config_home/robisie/backups/." "$backup/robisie/backups/"
|
|
289
|
+
cp -Rp -- "$config_home/robisie/roles/codex/." "$backup/robisie/roles/codex/"
|
|
290
|
+
cp -p -- "$HOME/.claude.json" "$backup/claude/claude.json"
|
|
291
|
+
cp -p -- "$HOME/.claude/agents/ceo-client.md" "$backup/claude/agents/ceo-client.md"
|
|
292
|
+
cp -p -- "$HOME/.claude/agents/manager-builder-client.md" "$backup/claude/agents/manager-builder-client.md"
|
|
293
|
+
cp -p -- "$HOME/.claude/agents/quality-officer-client.md" "$backup/claude/agents/quality-officer-client.md"
|
|
294
|
+
cp -p -- "$codex_home/config.toml" "$backup/codex/config.toml"
|
|
295
|
+
cp -p -- "$codex_home/AGENTS.md" "$backup/codex/AGENTS.md"
|
|
296
|
+
cp -p -- "$config_home/opencode/opencode.json" "$backup/opencode/opencode.json"
|
|
297
|
+
cp -p -- "$config_home/opencode/agents/ceo-client.md" "$backup/opencode/agents/ceo-client.md"
|
|
298
|
+
cp -p -- "$config_home/opencode/agents/manager-builder-client.md" "$backup/opencode/agents/manager-builder-client.md"
|
|
299
|
+
cp -p -- "$config_home/opencode/agents/quality-officer-client.md" "$backup/opencode/agents/quality-officer-client.md"
|
|
300
|
+
cp -p -- "$config_home/opencode/plugins/robisie-review-guard.js" "$backup/opencode/plugins/robisie-review-guard.js"
|
|
301
|
+
cp -p -- "$profile" "$backup/profile/selected"
|
|
302
|
+
cp -p -- "$entry_path" "$backup/entries/$entry_id"
|
|
303
|
+
```
|
|
304
|
+
|
|
305
|
+
Przywracanie: te same pary źródło/kopia w tej samej kolejności, dopiero po porównaniu.
|
|
306
|
+
|
|
307
|
+
```sh
|
|
308
|
+
cp -p -- "$backup/project/package.json" "$PWD/package.json"
|
|
309
|
+
cp -p -- "$backup/project/package-lock.json" "$PWD/package-lock.json"
|
|
310
|
+
cp -p -- "$backup/project/robisie.config.json" "$PWD/robisie.config.json"
|
|
311
|
+
cp -p -- "$backup/robisie/key" "$config_home/robisie/key"
|
|
312
|
+
cp -p -- "$backup/robisie/manifest.json" "$config_home/robisie/manifest.json"
|
|
313
|
+
cp -Rp -- "$backup/robisie/backups/." "$config_home/robisie/backups/"
|
|
314
|
+
cp -Rp -- "$backup/robisie/roles/codex/." "$config_home/robisie/roles/codex/"
|
|
315
|
+
cp -p -- "$backup/claude/claude.json" "$HOME/.claude.json"
|
|
316
|
+
cp -p -- "$backup/claude/agents/ceo-client.md" "$HOME/.claude/agents/ceo-client.md"
|
|
317
|
+
cp -p -- "$backup/claude/agents/manager-builder-client.md" "$HOME/.claude/agents/manager-builder-client.md"
|
|
318
|
+
cp -p -- "$backup/claude/agents/quality-officer-client.md" "$HOME/.claude/agents/quality-officer-client.md"
|
|
319
|
+
cp -p -- "$backup/codex/config.toml" "$codex_home/config.toml"
|
|
320
|
+
cp -p -- "$backup/codex/AGENTS.md" "$codex_home/AGENTS.md"
|
|
321
|
+
cp -p -- "$backup/opencode/opencode.json" "$config_home/opencode/opencode.json"
|
|
322
|
+
cp -p -- "$backup/opencode/agents/ceo-client.md" "$config_home/opencode/agents/ceo-client.md"
|
|
323
|
+
cp -p -- "$backup/opencode/agents/manager-builder-client.md" "$config_home/opencode/agents/manager-builder-client.md"
|
|
324
|
+
cp -p -- "$backup/opencode/agents/quality-officer-client.md" "$config_home/opencode/agents/quality-officer-client.md"
|
|
325
|
+
cp -p -- "$backup/opencode/plugins/robisie-review-guard.js" "$config_home/opencode/plugins/robisie-review-guard.js"
|
|
326
|
+
cp -p -- "$backup/profile/selected" "$profile"
|
|
327
|
+
cp -p -- "$backup/entries/$entry_id" "$entry_path"
|
|
328
|
+
```
|
|
280
329
|
|
|
281
330
|
Gdy tgz i wszystkie wybrane kopie są gotowe, aktualizuj. Init nie czyta pliku key automatycznie: pierwszeństwo ma ROBISIE_KEY, potem ukryte pytanie w terminalu, potem jawny `--key-stdin` (np. automatyzacja bez terminala). Sam plik key nie wystarcza. Wczytaj stary klucz PRZED init/doctor z tego samego XDG_CONFIG_HOME; osobne przypisanie przed export i `&&` zachowują błąd odczytu bez wydruku klucza:
|
|
282
331
|
|
|
@@ -307,9 +356,9 @@ Doctor sprawdza MAJOR kontraktu; exit 0 wymaga także pozostałych kontroli. Prz
|
|
|
307
356
|
|
|
308
357
|
### Powrót do poprzedniego wydania
|
|
309
358
|
|
|
310
|
-
Przed nadpisaniem zachowaj późniejsze własne zmiany w NOWEJ prywatnej kopii (`umask 077`, np. `later="$(mktemp -d "$HOME/robisie-later.XXXXXX")"`). Powtórz przygotowanie katalogów i
|
|
359
|
+
Przed nadpisaniem zachowaj późniejsze własne zmiany w NOWEJ prywatnej kopii (`umask 077`, np. `later="$(mktemp -d "$HOME/robisie-later.XXXXXX")"`). Powtórz przygotowanie katalogów i blok kopii, podstawiając `$later` zamiast `$backup`, bez zmiany starej kopii. Porównaj lokalnie i scal własne zmiany z kopią poprzedniego wydania; konfiguracja może zawierać klucz, więc bez publikowania diffu. Przy nieczytelnej konfiguracji, linku lub nierozstrzygniętym porównaniu przerwij nadpisywanie. Nie ma obietnicy automatycznego rollbacku.
|
|
311
360
|
|
|
312
|
-
Po porównaniu wykonaj wybrane komendy z
|
|
361
|
+
Po porównaniu wykonaj wybrane komendy z bloku przywracania do tych samych celów, zachowując pominięcia z absent.txt. Polecenia katalogów kopiują zawartość przez `/.`, bez zagnieżdżania kolejnego katalogu; przed restore przygotuj sprawdzone katalogi celów, jeśli ich brakuje. Przy scalaniu `backups/` i `roles/codex/` nie usuwaj dodatkowych późniejszych plików. Najpierw przywróć `package.json` ORAZ `package-lock.json`. Potem w tym samym cwd wczytaj przywrócony stary klucz do ENV, zainstaluj zachowany zgodny tgz i dopiero wykonaj init oraz doctor:
|
|
313
362
|
|
|
314
363
|
<!-- restore:start -->
|
|
315
364
|
```sh
|
|
@@ -336,7 +385,7 @@ npx robisie doctor
|
|
|
336
385
|
|
|
337
386
|
Opcja `--no-save` zachowuje przywrócone `package.json` i `package-lock.json`, bez zapisywania zależności `file:` od ścieżki prywatnej kopii.
|
|
338
387
|
|
|
339
|
-
Po każdej osobnej komendzie
|
|
388
|
+
Po każdej osobnej wybranej komendzie sprawdź jej status; błąd zatrzymuje przepis. Łańcuch zatrzymuje się sam. Nie maskuj odczytu ani nie łącz przypisania klucza z export. W razie błędu zachowaj obie kopie i skorzystaj z porady doctor, bez dalszego nadpisywania.
|
|
340
389
|
|
|
341
390
|
<!-- sekcja: odinstalowanie -->
|
|
342
391
|
## Odinstalowanie
|
|
@@ -357,17 +406,24 @@ Bez instalacji zacznij od konta i Connect → init; samo ponawianie doctor nie z
|
|
|
357
406
|
|
|
358
407
|
Komunikaty CLI pozostają po polsku. Dopasuj komunikat, a potem wykonaj wskazaną czynność:
|
|
359
408
|
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
409
|
+
- **brak-klucza** — `Brak klucza robisie.`
|
|
410
|
+
Wygeneruj klucz w Connect i przekaż go do init.
|
|
411
|
+
- **odrzucony-klucz** — `Serwer robisie odrzucił klucz (nieważny albo unieważniony).`
|
|
412
|
+
Wygeneruj nowy klucz worker; w zsh/bash wykonaj `unset ROBISIE_KEY`, potem init z ukrytym pytaniem.
|
|
413
|
+
- **brak-odczytu** — `Ten klucz nie ma uprawnień do odczytu tablicy (np. rola seeder).`
|
|
414
|
+
Wybierz worker w Connect; `unset ROBISIE_KEY`, potem init z ukrytym pytaniem.
|
|
415
|
+
- **major** — `Wersja kontraktu serwera (2.0.0) nie pasuje do paczki robisie 0.1.4 (obsługuje 1.x).`
|
|
416
|
+
Przykład niezgodnego MAJOR: zainstaluj wydanie zgodne z kontraktem serwera.
|
|
417
|
+
- **brak-env** — `Zmienna ROBISIE_KEY nie jest ustawiona — role i agenci jej potrzebują.`
|
|
418
|
+
Sprawdź obsługę profilu; przy --no-shell/innej powłoce wczytaj plik klucza do środowiska sesji jak w init, potem doctor.
|
|
419
|
+
- **brak-programu** — `katalog jest, programu nie ma w PATH`
|
|
420
|
+
Zainstaluj program wskazanego dostawcy lub dodaj go do PATH; sam katalog konfiguracji nie wystarcza.
|
|
421
|
+
- **brak-programu-i-katalogu** — `brak programu w PATH i katalogu dostawcy`
|
|
422
|
+
Zainstaluj wybrany program, ponów init z pełną wspólną mapą i doctor.
|
|
423
|
+
- **jsonc** — `nie zmieniam automatycznie`
|
|
424
|
+
Zachowaj JSONC; przygotuj wspierany JSON albo wybierz innego dostawcę dla wszystkich ról. Sam zdalny MCP nie wystarcza.
|
|
425
|
+
- **niepelna-instalacja** — `Claude Code: niepełna instalacja`
|
|
426
|
+
Przykład brakującej konfiguracji: ponów init dla swojego agenta.
|
|
371
427
|
|
|
372
428
|
Po naprawie przy istniejącej ewidencji wczytaj zapisany klucz według Aktualizacji przed lokalnym `npx robisie init` i `npx robisie doctor`; przy braku plików paczki przeinstaluj ją z npm, przy MAJOR uzyskaj zgodne wydanie. Przy braku ewidencji zachowaj dane i zastosuj poradę doctor zamiast init w ciemno. Jeśli problem pozostaje, przekaż zespołowi komunikat, wersję i cwd bez klucza. Przy uninstall wynik to usunięte wpisy i exit 0; kod 1 wymaga wskazanej naprawy, nie oznacza pełnego usunięcia.
|
|
373
429
|
|
package/docs/RELEASE-0.1.0.md
CHANGED
|
@@ -88,9 +88,11 @@ export const config = parseConfig({
|
|
|
88
88
|
- `dist/role-registry.js`
|
|
89
89
|
- `dist/role-results.js`
|
|
90
90
|
- `dist/roles.js`
|
|
91
|
+
- `dist/seed-package.js`
|
|
91
92
|
- `dist/seed-validation.js`
|
|
92
93
|
- `dist/selection-result.js`
|
|
93
94
|
- `dist/sparse-policy.js`
|
|
95
|
+
- `dist/task-mktemp.js`
|
|
94
96
|
- `dist/tester-identity.js`
|
|
95
97
|
- `dist/worker-env.js`
|
|
96
98
|
- `helpers/ceo-client-launcher-mcp.mjs` → `spawn_builder`
|
package/package.json
CHANGED