robisie 0.5.34 → 0.5.36

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.
@@ -141,6 +141,7 @@ declare const acceptReviewInput: z.ZodObject<{
141
141
  submissionId: z.ZodUUID;
142
142
  snapshot: z.ZodString;
143
143
  providerDeclared: z.ZodString;
144
+ receiverIndependenceWaived: z.ZodOptional<z.ZodLiteral<true>>;
144
145
  }, z.core.$strict>;
145
146
  export type ReviewSnapshot = z.infer<typeof reviewSnapshotSchema>;
146
147
  export type AcceptReviewInput = z.infer<typeof acceptReviewInput>;
@@ -70,7 +70,7 @@ const reviewSnapshotInput = z.strictObject({ id: uuid });
70
70
  const reviewSnapshotSchema = z.object({ cardId: uuid, projectId: uuid, submissionId: uuid,
71
71
  snapshot: z.string().regex(/^[a-f0-9]{64}$/), label: z.literal("recenzja innym kluczem; dostawca deklarowany") });
72
72
  const acceptReviewInput = z.strictObject({ id: uuid, cardId: uuid, projectId: uuid, submissionId: uuid,
73
- snapshot: z.string().regex(/^[a-f0-9]{64}$/), providerDeclared: z.string().trim().min(1).max(200) })
73
+ snapshot: z.string().regex(/^[a-f0-9]{64}$/), providerDeclared: z.string().trim().min(1).max(200), receiverIndependenceWaived: z.literal(true).optional() })
74
74
  .refine(value => value.id === value.cardId);
75
75
  // reserve_task still transfers full server PlannerTask/details; only these fields leave this adapter.
76
76
  const reservationSchema = z.object({ id: uuid, status, assignee: z.string().nullable(), trackId: uuid, updatedAt: date });
@@ -1,18 +1,21 @@
1
1
  import { type Ctx } from "./context.js";
2
2
  import { type EngineConfig } from "./engine-config.js";
3
- declare const ROLES: readonly ["worker-client", "lead-client", "reviewer-client", "tester-client"];
3
+ declare const ROLES: readonly ["worker-client", "lead-client", "reviewer-client", "tester-client", "receiver-client"];
4
4
  export declare const PROVIDERS: readonly ["codex", "claude", "opencode", "grok"];
5
- export type EngineRoleRegistry = Record<typeof ROLES[number], {
5
+ export type EngineRoleEntry = {
6
6
  name: string;
7
7
  provider: typeof PROVIDERS[number];
8
8
  model: string;
9
9
  effort: string;
10
10
  requireIndependentProvider?: boolean;
11
- }>;
11
+ };
12
+ export type EngineRoleRegistry = Record<Exclude<typeof ROLES[number], "receiver-client">, EngineRoleEntry> & {
13
+ "receiver-client"?: EngineRoleEntry;
14
+ };
12
15
  /** Separate from K2 roles (names/inflections) and K7's resource RoleRegistry. */
13
16
  export declare function parseRoleRegistry(raw: unknown, configPath: string): EngineRoleRegistry;
14
17
  /** Shared client execution contract; host registries retain their existing choices. */
15
- export declare function validateClientRoles(worker: EngineRoleRegistry["worker-client"], reviewer: EngineRoleRegistry["reviewer-client"]): void;
18
+ export declare function validateClientRoles(worker: EngineRoleRegistry["worker-client"], reviewer: EngineRoleRegistry["reviewer-client"], receiver?: EngineRoleEntry): void;
16
19
  /** Select CLI/model/effort from the parsed registry; manufacturer and profile metadata belong to the caller. */
17
20
  export declare function resolveRoleExecution(registry: EngineRoleRegistry, role: string): {
18
21
  provider: typeof PROVIDERS[number];
@@ -3,7 +3,7 @@ import { resolve } from "node:path";
3
3
  import { RobisieError, errorMessage } from "./context.js";
4
4
  import { CONFIG_FILE, parseEngineConfig } from "./engine-config.js";
5
5
  // K7 ROLE_NAMES; kept local so the package has no vendor runtime dependency.
6
- const ROLES = ["worker-client", "lead-client", "reviewer-client", "tester-client"];
6
+ const ROLES = ["worker-client", "lead-client", "reviewer-client", "tester-client", "receiver-client"];
7
7
  export const PROVIDERS = ["codex", "claude", "opencode", "grok"];
8
8
  const FIELDS = ["name", "provider", "model", "effort"];
9
9
  function fail(configPath, field, reason) {
@@ -24,12 +24,14 @@ export function parseRoleRegistry(raw, configPath) {
24
24
  }
25
25
  const result = {};
26
26
  for (const role of ROLES) {
27
+ if (role === "receiver-client" && !Object.hasOwn(registry, role))
28
+ continue;
27
29
  const path = `roleRegistry.${role}`;
28
30
  if (!Object.hasOwn(registry, role) || !object(registry[role]))
29
31
  fail(configPath, path, "wymagany własny wpis {name, provider, model, effort}");
30
32
  const entry = registry[role];
31
33
  for (const key of Object.keys(entry)) {
32
- if (!FIELDS.includes(key) && !(role === "reviewer-client" && key === "requireIndependentProvider"))
34
+ if (!FIELDS.includes(key) && !(["reviewer-client", "receiver-client"].includes(role) && key === "requireIndependentProvider"))
33
35
  fail(configPath, path, "nieznane pole; dozwolone: " + FIELDS.join(", "));
34
36
  }
35
37
  for (const field of FIELDS) {
@@ -42,6 +44,10 @@ export function parseRoleRegistry(raw, configPath) {
42
44
  }
43
45
  if (Object.hasOwn(entry, "requireIndependentProvider") && typeof entry.requireIndependentProvider !== "boolean")
44
46
  fail(configPath, `${path}.requireIndependentProvider`, "wymagany boolean true albo false");
47
+ if (role === "receiver-client" && (!["codex", "claude", "grok"].includes(String(entry.provider))
48
+ || String(entry.model).startsWith("-") || !["low", "medium", "high", "xhigh"].includes(String(entry.effort))
49
+ || entry.provider === "grok" && !/^grok-/.test(String(entry.model))))
50
+ fail(configPath, path, "odbiorca wymaga Codex, Claude albo Grok, jawnego modelu i effort low/medium/high/xhigh");
45
51
  result[role] = { name: entry.name, provider: entry.provider,
46
52
  model: entry.model, effort: entry.effort,
47
53
  ...(Object.hasOwn(entry, "requireIndependentProvider") ? { requireIndependentProvider: entry.requireIndependentProvider } : {}) };
@@ -49,7 +55,7 @@ export function parseRoleRegistry(raw, configPath) {
49
55
  return result;
50
56
  }
51
57
  /** Shared client execution contract; host registries retain their existing choices. */
52
- export function validateClientRoles(worker, reviewer) {
58
+ export function validateClientRoles(worker, reviewer, receiver) {
53
59
  if (worker.provider !== "codex" || !["codex", "claude", "grok"].includes(reviewer.provider))
54
60
  throw new RobisieError("Worker klienta wymaga Codex; recenzent klienta: Codex, Claude albo Grok.", "Wybierz obsługiwanego dostawcę w rejestrze.");
55
61
  if (Object.hasOwn(reviewer, "requireIndependentProvider") && typeof reviewer.requireIndependentProvider !== "boolean")
@@ -58,6 +64,8 @@ export function validateClientRoles(worker, reviewer) {
58
64
  throw new RobisieError("Recenzent Grok wymaga grok-cli/none.", "Popraw model i effort recenzenta.");
59
65
  if (reviewer.provider === worker.provider && reviewer.requireIndependentProvider !== false)
60
66
  throw new RobisieError("Wymagana niezależność: wybierz innego dostawcę lub jawnie wyłącz wymóg przez requireIndependentProvider=false.", "Wybierz innego dostawcę lub jawne false.");
67
+ if (receiver && receiver.provider === worker.provider && receiver.requireIndependentProvider !== false)
68
+ throw new RobisieError("Niezależność odbiorcy: wybierz innego dostawcę albo świadome requireIndependentProvider=false.", "Wybierz innego dostawcę albo świadome false.");
61
69
  }
62
70
  /** Select CLI/model/effort from the parsed registry; manufacturer and profile metadata belong to the caller. */
63
71
  export function resolveRoleExecution(registry, role) {
@@ -65,6 +73,8 @@ export function resolveRoleExecution(registry, role) {
65
73
  throw new RobisieError("Brak wybranej roli w rejestrze.", "Wybierz rolę obecną w sprawdzonej konfiguracji rejestru.");
66
74
  }
67
75
  const entry = registry[role];
76
+ if (!entry)
77
+ throw new RobisieError("Brak wybranej roli w rejestrze.", "Wybierz rolę obecną w konfiguracji.");
68
78
  return { provider: entry.provider, model: entry.model, effortRequested: entry.effort };
69
79
  }
70
80
  /** One read and one JSON object shared by the K2 and registry validators. */
@@ -100,7 +110,10 @@ export function doctorEngineConfig(ctx, path, afterLoad) {
100
110
  const { roleRegistry, config } = loadRoleRegistryConfig(resolve(ctx.cwd, path));
101
111
  afterLoad?.(config, roleRegistry);
102
112
  for (const role of ROLES) {
103
- const { name, provider, model, effort } = roleRegistry[role];
113
+ const entry = roleRegistry[role];
114
+ if (!entry)
115
+ continue;
116
+ const { name, provider, model, effort } = entry;
104
117
  ctx.out(`${role} → ${name} / ${provider} / ${model} / ${effort}`);
105
118
  }
106
119
  ctx.out("✓ sprawdzono konfigurację; nie sprawdzono uruchomienia dostawców");
package/dist/roles.d.ts CHANGED
@@ -17,7 +17,7 @@ export interface Role {
17
17
  export declare function rolesDir(): string;
18
18
  export declare function parseRole(file: Role["file"], text: string): Role;
19
19
  export declare function loadRoles(dir?: string): Role[];
20
- export declare const MANAGED_LINE = "<!-- robisie:managed 0.5.34 \u2014 plik zarz\u0105dzany przez `npx robisie`; `npx robisie uninstall` go usunie -->";
20
+ export declare const MANAGED_LINE = "<!-- robisie:managed 0.5.36 \u2014 plik zarz\u0105dzany przez `npx robisie`; `npx robisie uninstall` go usunie -->";
21
21
  export type AgentFlavor = "claude" | "codex" | "opencode";
22
22
  /** How the operator starts the Builder for one card in its own session (the card id is not a secret). */
23
23
  export declare function builderStartCommand(flavor: AgentFlavor, codexRolePath?: string): string;
package/docs/README.en.md CHANGED
@@ -1,4 +1,4 @@
1
- # robisie — from account to accepted card (package 0.5.34) <!-- x-release-please-version -->
1
+ # robisie — from account to accepted card (package 0.5.36) <!-- 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
 
@@ -7,7 +7,7 @@ Polski: [README.md](README.md).
7
7
  <!-- sekcja: dostepnosc -->
8
8
  ## Availability
9
9
 
10
- An account and key are needed for init and the roles. `npx robisie doctor --engine-config ./robisie.config.json` with explicit `engine.mode:host` checks structure and local installation inputs offline, without CLI checks. With `engine.mode:client` or a missing `engine.mode` field, after input validation and when the program is available, it also checks CLI presence and login: `codex login status` and `grok models` (`grok models` requires a network; Grok confirms login only probably), plus `claude auth status` only when `reviewer-client.provider: claude`. A missing program does not check login. Neither mode runs a real AI task or engine commands, and neither confirms project UUID, repo or models. The guides shipped in this package are local at `node_modules/robisie/docs/README.md` and `node_modules/robisie/docs/README.en.md`; no website fetch is needed.
10
+ An account and key are needed for init and the roles. `npx robisie doctor --engine-config ./robisie.config.json` with explicit `engine.mode:host` checks structure and local installation inputs offline, without CLI checks. With `engine.mode:client` or a missing `engine.mode` field, after input validation and when the program is available, it also checks CLI presence and login: `codex login status` and `grok models` (`grok models` requires a network; Grok confirms login only probably), plus `claude auth status` when `reviewer-client.provider: claude` or `receiver-client.provider: claude`. A missing program does not check login. Neither mode runs a real AI task or engine commands, and neither confirms project UUID, repo or models. The guides shipped in this package are local at `node_modules/robisie/docs/README.md` and `node_modules/robisie/docs/README.en.md`; no website fetch is needed.
11
11
 
12
12
  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).
13
13
 
@@ -83,6 +83,12 @@ All three installer roles use one provider: CEO (`ceo`), Builder (`builder`), Qu
83
83
 
84
84
  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.
85
85
 
86
+ Optional `roleRegistry.receiver-client` selects a separate receiver: `provider: codex` (OpenAI), `claude` (Anthropic) or `grok` (xAI), without OpenCode. Omitting the row retains default Grok / `grok-cli` / `low`, including historical recovery; do not add a row just for defaults. Fields are `name`, `provider`, `model`, `effort` (`low`, `medium`, `high`, `xhigh`); Grok accepts `grok-cli` or an explicit `grok-*`, while `none` is legacy evidence only. Missing `requireIndependentProvider` or `true` requires a provider different from every author. Only the receiver's frozen `false` permits a shared provider, including Codex with a Codex Worker; reviewer partial alone does not waive receiver independence. A separate process is required: never reuse the same agent, conversation, session or job of the Worker or reviewer. The selection is frozen beside the pair; changing the row or flag presence stops acceptance after restart too. Receiver or reviewer `false` produces `acceptance.partial` (`independence_level: partial`) with the visible Polish note “częściowa: bez niezależnego sprawdzenia”. Only `accept_review` writes protected `review_receipt.receiverIndependenceWaived=true` for the receiver exception; loose details or a note cannot replace it. Logged-in Codex and Grok CLIs remain required; Claude is required when either reviewer or receiver uses it. Update the server alongside the npm package: older servers cannot handle this protected exception. Example additional `roleRegistry` entry:
87
+
88
+ ```json
89
+ {"receiver-client":{"name":"Receiver","provider":"codex","model":"gpt-6.1-sol","effort":"high","requireIndependentProvider":false}}
90
+ ```
91
+
86
92
  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:
87
93
 
88
94
  ```sh
@@ -276,7 +282,7 @@ git commit -m "Przygotuj lokalne powitanie"
276
282
  ```
277
283
  <!-- local-repo-setup:end -->
278
284
 
279
- 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` can select Codex, Claude or Grok. Grok still requires `provider: grok`, `model: grok-cli`, `effort: none`. Only the reviewer supports optional boolean `requireIndependentProvider`: absent or `true` requires another provider; Codex requires explicit `false`. Every `false`, including Claude or Grok, marks review and acceptance as `partial` with the note “częściowa: bez niezależnego sprawdzenia”. Review always runs in a separate process. An unsupported pair or a configuration change during the card causes `HOLD clientPair`. 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. Set the Codex or Claude reviewer model and effort in the registry; the installed Grok CLI selects its model (`grok-cli` / `none`). The local flow needs an available, signed-in Codex Worker, the selected reviewer, and Grok for acceptance. `doctor --engine-config` with explicit `engine.mode:host` checks structure offline, without CLI checks. With `engine.mode:client` or a missing `engine.mode` field, after input validation and when the program is available, it checks this pair and login: `codex login status` and `grok models` (`grok models` requires a network; Grok confirms login only probably), plus `claude auth status` only when `reviewer-client.provider: claude`. A missing program does not check login, and a missing CLI or unconfirmed login prevents readiness. Neither mode runs a real AI task. Parsing and this doctor do not prove model or provider availability. This execution registry is separate from the installer’s CEO/Builder/Quality Officer map.
285
+ 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` can select Codex, Claude or Grok. Grok still requires `provider: grok`, `model: grok-cli`, `effort: none`. The reviewer supports optional boolean `requireIndependentProvider`: absent or `true` requires another provider; Codex requires explicit `false`. Every reviewer `false`, including Claude or Grok, marks review and acceptance as `partial` with the note “częściowa: bez niezależnego sprawdzenia”. Review always runs in a separate process. An unsupported pair or a configuration change during the card causes `HOLD clientPair`. 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. Set the Codex or Claude reviewer model and effort in the registry; the installed Grok CLI selects its model (`grok-cli` / `none`). The local flow needs an available, signed-in Codex Worker, the selected reviewer and receiver, plus Grok. `doctor --engine-config` with explicit `engine.mode:host` checks structure offline, without CLI checks. With `engine.mode:client` or a missing `engine.mode` field, after input validation and when the program is available, it checks this pair and login: `codex login status` and `grok models` (`grok models` requires a network; Grok confirms login only probably), plus `claude auth status` when `reviewer-client.provider: claude` or `receiver-client.provider: claude`. A missing program does not check login, and a missing CLI or unconfirmed login prevents readiness. Neither mode runs a real AI task. Parsing and this doctor do not prove model or provider availability. This execution registry is separate from the installer’s CEO/Builder/Quality Officer map.
280
286
 
281
287
  <!-- local-engine-config:start -->
282
288
  ```json
@@ -632,6 +638,6 @@ After repair with an existing record, load the saved key as shown in Update befo
632
638
 
633
639
  The installer does not start background services or the Builder on its own; after operator approval, the CEO can start the Builder through `spawn_builder`. Helpers run during agent sessions using the project directory (or `ROBISIE_PROJECT_CONTEXT`) as context. The installer contacts robisie to check the contract and key; the package file does not provide an account or AI provider access. One shared key identity does not provide three different permission levels. Acceptance requires independent review, evidence and the operator's approval.
634
640
 
635
- Windows/WSL are unverified. `doctor --engine-config` with explicit `engine.mode:host` checks structure and local installation inputs offline, without CLI checks. With `engine.mode:client` or a missing `engine.mode` field, after input validation and when the program is available, it checks CLI presence and login: `codex login status` and `grok models` (`grok models` requires a network; Grok confirms login only probably), plus `claude auth status` only when `reviewer-client.provider: claude`. A missing program does not check login. Neither mode runs a real AI task or engine commands, and neither confirms project UUID, repo existence or model availability.
641
+ Windows/WSL are unverified. `doctor --engine-config` with explicit `engine.mode:host` checks structure and local installation inputs offline, without CLI checks. With `engine.mode:client` or a missing `engine.mode` field, after input validation and when the program is available, it checks CLI presence and login: `codex login status` and `grok models` (`grok models` requires a network; Grok confirms login only probably), plus `claude auth status` when `reviewer-client.provider: claude` or `receiver-client.provider: claude`. A missing program does not check login. Neither mode runs a real AI task or engine commands, and neither confirms project UUID, repo existence or model availability.
636
642
 
637
643
  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 or macOS for the client (`local`) or 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.5.34) <!-- x-release-please-version -->
1
+ # robisie — od konta do odebranej karty (paczka 0.5.36) <!-- 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
 
@@ -9,7 +9,7 @@ English: [README.en.md](README.en.md).
9
9
  <!-- sekcja: dostepnosc -->
10
10
  ## Dostępność
11
11
 
12
- Konto i klucz są potrzebne do init i pracy ról. `npx robisie doctor --engine-config ./robisie.config.json` przy jawnym `engine.mode:host` sprawdza offline strukturę konfiguracji i wejścia instalacji lokalnej, bez kontroli CLI. Przy `engine.mode:client` albo braku pola `engine.mode`, po walidacji wejść i przy dostępnym programie, sprawdza obecność CLI oraz logowanie: `codex login status` i `grok models` (`grok models` wymaga sieci; Grok potwierdza logowanie tylko prawdopodobnie), a `claude auth status` wyłącznie przy `reviewer-client.provider: claude`. Brak programu nie pozwala sprawdzić logowania. Żaden tryb nie wykonuje prawdziwego zadania AI ani komend silnika i nie potwierdza UUID projektu, repo ani modeli. Przewodniki z tej paczki znajdziesz lokalnie w `node_modules/robisie/docs/README.md` i `node_modules/robisie/docs/README.en.md`; nie trzeba pobierać ich ze strony.
12
+ Konto i klucz są potrzebne do init i pracy ról. `npx robisie doctor --engine-config ./robisie.config.json` przy jawnym `engine.mode:host` sprawdza offline strukturę konfiguracji i wejścia instalacji lokalnej, bez kontroli CLI. Przy `engine.mode:client` albo braku pola `engine.mode`, po walidacji wejść i przy dostępnym programie, sprawdza obecność CLI oraz logowanie: `codex login status` i `grok models` (`grok models` wymaga sieci; Grok potwierdza logowanie tylko prawdopodobnie), a `claude auth status` przy `reviewer-client.provider: claude` lub `receiver-client.provider: claude`. Brak programu nie pozwala sprawdzić logowania. Żaden tryb nie wykonuje prawdziwego zadania AI ani komend silnika i nie potwierdza UUID projektu, repo ani modeli. Przewodniki z tej paczki znajdziesz lokalnie w `node_modules/robisie/docs/README.md` i `node_modules/robisie/docs/README.en.md`; nie trzeba pobierać ich ze strony.
13
13
 
14
14
  Zainstaluj robisie z npm w przygotowanym katalogu; w nim uruchamiaj dalsze polecenia i sesje agentów. [Przygotowanie](#wymagania) → [konto](#konto) → [klucz](#klucz) → [instalacja](#instalacja) → [odbiór](#recenzja-i-odbior).
15
15
 
@@ -83,6 +83,12 @@ Trzy role instalatora używają jednego dostawcy: CEO (`ceo`), Builder (`builder
83
83
 
84
84
  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.
85
85
 
86
+ Opcjonalny `roleRegistry.receiver-client` wybiera osobnego odbierającego: `provider: codex` (OpenAI), `claude` (Anthropic) albo `grok` (xAI), bez OpenCode. Brak wiersza zachowuje domyślny Grok / `grok-cli` / `low`, także dla historycznych odbiorów; nie dopisuj wiersza dla samych defaults. Wpis ma `name`, `provider`, `model`, `effort` (`low`, `medium`, `high`, `xhigh`); Grok używa `grok-cli` albo jawnego `grok-*`, a `none` dotyczy tylko archiwów. Brak `requireIndependentProvider` lub `true` wymaga innego dostawcy niż każdy autor. Wyłącznie zamrożone `false` odbiorcy pozwala na wspólnego dostawcę, np. Codex przy Workerze Codex; recenzencki partial sam nie daje tego wyjątku. Odbiór nadal wymaga osobnego procesu: nie wolno użyć tego samego agenta, jego rozmowy, sesji ani joba Workera lub recenzenta. Wybór zostaje zamrożony obok pary; zmiana wpisu lub obecności flagi w trakcie karty zatrzymuje odbiór także po restarcie. `false` odbiorcy albo recenzenta oznacza `acceptance.partial` (pole `independence_level: partial`) i widoczną notę „częściowa: bez niezależnego sprawdzenia”. Tylko `accept_review` zapisuje chroniony `review_receipt.receiverIndependenceWaived=true` dla wyjątku odbiorcy; luźne details ani sama nota go nie zastąpią. Wymagane są zalogowane CLI Codex, Grok (nadal wymagany) oraz Claude, jeśli recenzent lub odbiorca wybiera Claude. Aktualizuj serwer obok paczki npm: starszy serwer nie obsłuży chronionego wyjątku. Przykładowy dodatkowy wpis do `roleRegistry`:
87
+
88
+ ```json
89
+ {"receiver-client":{"name":"Odbiorca","provider":"codex","model":"gpt-6.1-sol","effort":"high","requireIndependentProvider":false}}
90
+ ```
91
+
86
92
  Agent bez terminala interaktywnego korzysta z [instalacji przez agenta](#instalacja-agenta).
87
93
 
88
94
  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:
@@ -321,7 +327,7 @@ git commit -m "Przygotuj lokalne powitanie"
321
327
  ```
322
328
  <!-- local-repo-setup:end -->
323
329
 
324
- 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` może wybrać Codex, Claude albo Grok. Grok nadal wymaga `provider: grok`, `model: grok-cli`, `effort: none`. Tylko recenzent ma opcjonalne boolean `requireIndependentProvider`: brak lub `true` wymaga innego dostawcy; Codex wymaga jawnego `false`. Każde `false`, także przy Claude lub Groku, zapisuje review i acceptance jako `partial` z notą „częściowa: bez niezależnego sprawdzenia”. Recenzja zawsze działa w osobnym procesie. Niedozwolona para lub zmiana konfiguracji w trakcie karty daje `HOLD clientPair`. 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. Dla Codex i Claude ustaw model oraz effort recenzenta w rejestrze; model Groka wybiera zainstalowany Grok CLI (`grok-cli` / `none`). Lokalny przebieg wymaga dostępnego i zalogowanego Codexa Workera, wybranego recenzenta oraz Groka odbiorcy. `doctor --engine-config` przy jawnym `engine.mode:host` sprawdza strukturę offline, bez kontroli CLI. Przy `engine.mode:client` albo braku pola `engine.mode` sprawdza tę parę i logowanie po walidacji wejść i przy dostępnym programie: `codex login status` i `grok models` (`grok models` wymaga sieci; Grok potwierdza logowanie tylko prawdopodobnie), a `claude auth status` wyłącznie przy `reviewer-client.provider: claude`. Brak programu nie pozwala sprawdzić logowania; brak CLI lub potwierdzenia logowania nie daje gotowości. Żaden tryb nie wykonuje prawdziwego zadania AI. Same parsowanie i ten doctor nie dowodzą dostępności modeli ani dostawców. Rejestr wykonania jest odrębny od mapy instalatora CEO/Builder/Quality Officer.
330
+ 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` może wybrać Codex, Claude albo Grok. Grok nadal wymaga `provider: grok`, `model: grok-cli`, `effort: none`. Recenzent ma opcjonalne boolean `requireIndependentProvider`: brak lub `true` wymaga innego dostawcy; Codex wymaga jawnego `false`. Każde `false` recenzenta, także przy Claude lub Groku, zapisuje review i acceptance jako `partial` z notą „częściowa: bez niezależnego sprawdzenia”. Recenzja zawsze działa w osobnym procesie. Niedozwolona para lub zmiana konfiguracji w trakcie karty daje `HOLD clientPair`. 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. Dla Codex i Claude ustaw model oraz effort recenzenta w rejestrze; model Groka wybiera zainstalowany Grok CLI (`grok-cli` / `none`). Lokalny przebieg wymaga dostępnego i zalogowanego Codexa Workera, wybranego recenzenta i odbiorcy oraz Groka. `doctor --engine-config` przy jawnym `engine.mode:host` sprawdza strukturę offline, bez kontroli CLI. Przy `engine.mode:client` albo braku pola `engine.mode` sprawdza tę parę i logowanie po walidacji wejść i przy dostępnym programie: `codex login status` i `grok models` (`grok models` wymaga sieci; Grok potwierdza logowanie tylko prawdopodobnie), a `claude auth status` przy `reviewer-client.provider: claude` lub `receiver-client.provider: claude`. Brak programu nie pozwala sprawdzić logowania; brak CLI lub potwierdzenia logowania nie daje gotowości. Żaden tryb nie wykonuje prawdziwego zadania AI. Same parsowanie i ten doctor nie dowodzą dostępności modeli ani dostawców. Rejestr wykonania jest odrębny od mapy instalatora CEO/Builder/Quality Officer.
325
331
 
326
332
  Worker Codex na Linuksie może uruchamiać testy tworzące procesy, ale proxy deny-all blokuje dostęp do internetu: komenda próbująca ruchu sieciowego zostanie PRZERWANA (exit −1), zamiast zwrócić zwykły błąd. Zależności przygotuj poza Workerem. Runner dopisuje `127.0.0.1,localhost` osobno do `NO_PROXY` i `no_proxy`, zachowując istniejące listy użytkownika i dostęp HTTP do localhost. Pomiar dotyczy Codex 0.166.0 na Linux aarch64; nie potwierdza rzeczywistego użycia u Dota na Linux x64 po wydaniu.
327
333
 
@@ -679,6 +685,6 @@ Po naprawie przy istniejącej ewidencji wczytaj zapisany klucz według Aktualiza
679
685
 
680
686
  Instalator nie uruchamia sam usług w tle ani Buildera; po zgodzie operatora CEO może uruchomić Buildera przez `spawn_builder`. Pomocniki działają podczas sesji agenta, z kontekstem katalogu projektu (lub `ROBISIE_PROJECT_CONTEXT`). Instalator łączy się z robisie w celu sprawdzenia kontraktu i klucza; plik paczki nie zapewnia konta ani dostępu do dostawcy AI. Jedna wspólna tożsamość klucza nie daje trzech różnych poziomów uprawnień. Odbiór wymaga niezależnej recenzji, dowodów i zgody operatora.
681
687
 
682
- Windows/WSL są niezweryfikowane. `doctor --engine-config` przy jawnym `engine.mode:host` sprawdza offline strukturę konfiguracji i wejścia, bez kontroli CLI; przy `engine.mode:client` albo braku pola `engine.mode`, po walidacji wejść i przy dostępnym programie, sprawdza CLI: `codex login status`, `grok models` (`grok models` wymaga sieci; Grok potwierdza logowanie tylko prawdopodobnie) i `claude auth status` wyłącznie przy `reviewer-client.provider: claude`. Brak programu nie pozwala sprawdzić logowania. Żaden tryb nie wykonuje prawdziwego zadania AI ani komend silnika i nie potwierdza UUID projektu, istnienia repo ani dostępności modeli.
688
+ Windows/WSL są niezweryfikowane. `doctor --engine-config` przy jawnym `engine.mode:host` sprawdza offline strukturę konfiguracji i wejścia, bez kontroli CLI; przy `engine.mode:client` albo braku pola `engine.mode`, po walidacji wejść i przy dostępnym programie, sprawdza CLI: `codex login status`, `grok models` (`grok models` wymaga sieci; Grok potwierdza logowanie tylko prawdopodobnie) i `claude auth status` przy `reviewer-client.provider: claude` lub `receiver-client.provider: claude`. Brak programu nie pozwala sprawdzić logowania. Żaden tryb nie wykonuje prawdziwego zadania AI ani komend silnika i nie potwierdza UUID projektu, istnienia repo ani dostępności modeli.
683
689
 
684
690
  Silnik paczki (`dist/engine/tick.cjs`) jest odrębny od instalatora: uruchamia go `npx robisie factory run --engine-config ./robisie.config.json` na Linuxie lub macOS dla klienta (`local`) oraz 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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "robisie",
3
- "version": "0.5.34",
3
+ "version": "0.5.36",
4
4
  "description": "Instalator klienta robisie: łączy agenta (Claude Code, Codex CLI, OpenCode) z tablicą robisie i instaluje role klienta.",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",