robisie 0.4.5 → 0.4.7

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 CHANGED
@@ -1,5 +1,19 @@
1
1
  # Historia zmian klienta / Client changelog
2
2
 
3
+ ## [0.4.7](https://github.com/chuppa12/robisie-app/compare/client-v0.4.6...client-v0.4.7) (2026-11-11)
4
+
5
+
6
+ ### Factory Cards
7
+
8
+ * praca workera task-mwb53tx1-k7ksqp (auto-commit) ([d335766](https://github.com/chuppa12/robisie-app/commit/d33576604d94c8a97d79587e23a0620aaa54fe3e))
9
+
10
+ ## [0.4.6](https://github.com/chuppa12/robisie-app/compare/client-v0.4.5...client-v0.4.6) (2026-11-10)
11
+
12
+
13
+ ### Bug Fixes
14
+
15
+ * **client:** jawny opt-in engine.receiver dla hosta + odbiorca związany z repo zadań (Z2-B) ([1126dc8](https://github.com/chuppa12/robisie-app/commit/1126dc83b77055ffdb0d11be7ce9480f234d16a2))
16
+
3
17
  ## [0.4.5](https://github.com/chuppa12/robisie-app/compare/client-v0.4.4...client-v0.4.5) (2026-11-10)
4
18
 
5
19
 
package/README.md CHANGED
@@ -34,7 +34,7 @@ Wymagane są dwa osobne klucze: A (`ROBISIE_KEY`, worker) i B (`ROBISIE_REVIEW_K
34
34
 
35
35
  A i B są zapisywane osobno w `${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key` i `review-key` (pliki 0600, katalog 0700). B nie trafia do konfiguracji agentów/modeli, manifestu, argumentów, claimów ani komunikatów. Załaduj oba ENV także przy `--no-shell`. Przed pierwszym zadaniem uruchom zwykły `npx robisie doctor`: tryb `--engine-config` nie sprawdza kluczy. Przy brakującym lub niepoprawnym A doctor diagnozuje A; sprawdzanie B zaczyna dopiero, gdy A jest obecny i ma poprawny format. Brak B, B=A, zły format i nieudany odczyt B dają exit 1. B sprawdzane jest przez `initialize` + `list_projects`, bez mutacji danych biznesowych; liczniki auth mogą wzrosnąć. Odczyt nie potwierdza roli, wspólnego konta A/B ani polityki projektu.
36
36
 
37
- Każdy wynik doctor zawiera `! Polityka enforced: NIE SPRAWDZONO — klient nie ma API jej odczytu.` Odmowa kontekstu projektu następuje przed doctor i ma własną poradę. Zielony doctor nie oznacza aktywacji enforced. Przy błędzie B sprawdź dostęp do Connect i wystawienie owner_validator; awaria sieci nie dowodzi unieważnienia. Ponów init z poprawnym B w ENV, potem doctor. Zmiana polityki wymaga osobnej uprawnionej czynności operatora.
37
+ Gdy klucz A widzi dokładnie jeden projekt, doctor odczytuje jego `reviewPolicy` przez `list_projects`: `enforced` daje „✓ Polityka enforced: TAK”, `legacy` ostrzega, że `accept_review` będzie odmawiane i wymaga ustawienia enforced przez operatora. Starszy serwer bez pola lub `null` daje „NIE SPRAWDZONO — serwer nie zwraca polityki”, błąd odczytu — „NIE SPRAWDZONO — odczyt nieudany”. Linia jest informacyjna i nie zmienia exit. Odmowa kontekstu projektu następuje przed doctor i ma własną poradę. Klient tylko odczytuje politykę, nie aktywuje enforced; zmienia ją uprawniony operator.
38
38
 
39
39
  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:
40
40
 
@@ -131,6 +131,8 @@ Po sukcesie człowiek potwierdza nazwę i cel projektu oraz katalog instalacji,
131
131
 
132
132
  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.
133
133
 
134
+ Dla lokalnego silnika użyj kompletnej karty i trzech użyć z `docs/README.md`, sekcja „Pierwsza karta i start Buildera”: literalne `details`, PASS/ACK testera, pełny `usage.json`, potem trzy różne `npx robisie usage --input ./usage.json`. CLI nie ocenia wyniku ani nie ustawia done. Przy odmowie sprawdź źródło przed ponowieniem — wpis może już istnieć. Dotychczasowa ręczna karta wynik.txt pozostaje osobnym przykładem.
135
+
134
136
  ## Start CEO
135
137
 
136
138
  Człowiek uruchamia CEO w katalogu instalacji.
package/dist/cli.d.ts CHANGED
@@ -12,6 +12,7 @@ export interface ParsedArgs {
12
12
  shell: boolean;
13
13
  keyStdin: boolean;
14
14
  engineConfig: string | null;
15
+ input: string | null;
15
16
  interval: number;
16
17
  once: boolean;
17
18
  /** login: false = `--no-wait`. */
package/dist/cli.js CHANGED
@@ -2,6 +2,7 @@
2
2
  import { lstatSync, realpathSync } from "node:fs";
3
3
  import { resolve } from "node:path";
4
4
  import { fileURLToPath } from "node:url";
5
+ import { z } from "zod";
5
6
  import { AGENT_IDS, isAgentId } from "./agents.js";
6
7
  import { doctor, init, recoveryStep, uninstall } from "./commands.js";
7
8
  import { HELPER_SERVERS, PACKAGE_VERSION } from "./constants.js";
@@ -13,6 +14,15 @@ import { isHelperServer, runHelper } from "./helpers.js";
13
14
  import { closeInstallation, initNeedsLogin, login, openInstallation } from "./login.js";
14
15
  import { ROLE_IDS, ROLE_STEP } from "./manifest.js";
15
16
  import { doctorEngineConfig } from "./role-registry.js";
17
+ import { bounded, runLocalUsage } from "./local-usage.js";
18
+ const usageText = z.string().trim().min(1);
19
+ const usageAt = z.iso.datetime({ offset: true });
20
+ const usageInput = z.strictObject({
21
+ repo: usageText, stateDir: usageText,
22
+ landed: z.strictObject({ sha: z.string().regex(/^[a-f0-9]{40}$/), at: usageAt }),
23
+ source: usageText, deadline: usageAt, operation: usageText,
24
+ program: z.strictObject({ entry: usageText, args: z.array(z.string()), artifact: usageText }),
25
+ });
16
26
  const HELP = `robisie ${PACKAGE_VERSION} — łączy Twojego agenta z tablicą robisie
17
27
 
18
28
  npx robisie login paruje instalację: kod i link zatwierdzasz w przeglądarce, klucze A i B trafiają prosto do plików
@@ -20,6 +30,8 @@ const HELP = `robisie ${PACKAGE_VERSION} — łączy Twojego agenta z tablicą r
20
30
  npx robisie doctor sprawdza A i B, wersję kontraktu, role i politykę enforced projektu
21
31
  npx robisie uninstall usuwa wpisy robisie i role; zachowuje kopie zapasowe
22
32
  npx robisie factory run nadzoruje kolejne takty silnika (Linux, Node.js >=24)
33
+ npx robisie usage --input ./usage.json
34
+ wykonuje jedno lokalne użycie na landed SHA i zapisuje zdarzenie JSON; nie ustawia done
23
35
  npx robisie mcp <${HELPER_SERVERS.join("|")}>
24
36
  pomocnik ról (serwer MCP stdio) — uruchamia go agent, nie Ty
25
37
 
@@ -30,6 +42,10 @@ Opcje factory run:
30
42
  --once jeden takt bez przerwy; wyklucza jawne --interval
31
43
  Ctrl+C zatrzymuje nadzorcę i grupę taktu; odłączone joby mogą działać dalej.
32
44
 
45
+ Opcje usage:
46
+ --input <plik.json> jeden niepusty plik JSON względem bieżącego katalogu, maksymalnie 256 KiB
47
+ --input=<plik.json> ta sama składnia; bez sieci i kluczy, --help nie czyta pliku
48
+
33
49
  Opcje doctor:
34
50
  --engine-config <path> offline sprawdza strukturę konfiguracji projektu i przypisania czterech ról wykonania oraz wejścia instalacji lokalnej
35
51
  --engine-config=<path> ta sama składnia; nie sprawdza uruchomienia dostawców
@@ -62,6 +78,7 @@ export function parseArgs(argv) {
62
78
  let shell = true;
63
79
  let keyStdin = false;
64
80
  let engineConfig = null;
81
+ let input = null;
65
82
  let target = null;
66
83
  let interval = 120;
67
84
  let intervalSet = false;
@@ -70,7 +87,7 @@ export function parseArgs(argv) {
70
87
  let timeout = null;
71
88
  // Help wins over everything else, so `init --help` never starts an install.
72
89
  if (argv.includes("--help") || argv.includes("-h"))
73
- return { command, help: true, target, agents: null, roles, shell, keyStdin, engineConfig, interval, once, wait, timeout };
90
+ return { command, help: true, target, agents: null, roles, shell, keyStdin, engineConfig, input, interval, once, wait, timeout };
74
91
  if (command === "factory") {
75
92
  target = args.shift() ?? null;
76
93
  if (target !== "run")
@@ -150,12 +167,23 @@ export function parseArgs(argv) {
150
167
  }
151
168
  timeout = Number(value);
152
169
  }
170
+ else if (arg === "--input" || arg.startsWith("--input=")) {
171
+ const step = "Użyj `npx robisie usage --input ./usage.json` z jedną niepustą ścieżką pliku.";
172
+ if (command !== "usage" || input !== null)
173
+ throw new RobisieError("Opcja --input jest dostępna tylko raz dla polecenia usage.", step);
174
+ const value = arg === "--input" ? args.shift() ?? "" : arg.slice("--input=".length);
175
+ if (!value.trim() || value.startsWith("-"))
176
+ throw new RobisieError("Opcja --input wymaga ścieżki pliku JSON.", step);
177
+ input = value;
178
+ }
153
179
  else
154
180
  throw new RobisieError("Nieznana opcja argumentów CLI.", "Zobacz `npx robisie help`.");
155
181
  }
156
182
  if (once && intervalSet)
157
183
  throw new RobisieError("Opcje --once i --interval wykluczają się.", "Zobacz `npx robisie help`.");
158
- return { command, help: false, target, agents: agents.length > 0 ? agents : null, roles, shell, keyStdin, engineConfig, interval, once, wait, timeout };
184
+ if (command === "usage" && input === null)
185
+ throw new RobisieError("Polecenie usage wymaga --input.", "Użyj `npx robisie usage --input ./usage.json`.");
186
+ return { command, help: false, target, agents: agents.length > 0 ? agents : null, roles, shell, keyStdin, engineConfig, input, interval, once, wait, timeout };
159
187
  }
160
188
  export async function run(argv, ctx) {
161
189
  let release = null;
@@ -189,6 +217,17 @@ export async function run(argv, ctx) {
189
217
  }
190
218
  }
191
219
  switch (args.command) {
220
+ case "usage": {
221
+ try {
222
+ const input = usageInput.parse(JSON.parse(bounded(resolve(ctx.cwd, args.input))));
223
+ const event = runLocalUsage({ ...input, repo: resolve(ctx.cwd, input.repo), stateDir: resolve(ctx.cwd, input.stateDir) });
224
+ ctx.out(JSON.stringify(event));
225
+ return 0;
226
+ }
227
+ catch (error) {
228
+ throw new RobisieError(`Odmowa użycia: ${error instanceof z.ZodError ? "Niepoprawny kontrakt JSON." : errorMessage(error)}`, "Sprawdź plik wejściowy oraz źródło stateDir/evidence/<source> przed ponowieniem; wpis może już istnieć. Popraw przyczynę odmowy, bez automatycznego retry.");
229
+ }
230
+ }
192
231
  case "init":
193
232
  await init(ctx, { agents: args.agents, roles: args.roles, shell: args.shell, keyStdin: args.keyStdin, ...(args.engineConfig === null ? {} : { engineConfig: args.engineConfig }) });
194
233
  return 0;
@@ -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.4.5";
3
+ export declare const PACKAGE_VERSION = "0.4.7";
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.4.5"; // x-release-please-version
3
+ export const PACKAGE_VERSION = "0.4.7"; // x-release-please-version
4
4
  /**
5
5
  * MAJOR of the agent-API contract this package understands.
6
6
  * PARITY: src/lib/mcp/contract-version.ts (AGENT_API_CONTRACT_VERSION) on the server.
@@ -1 +1 @@
1
- {"schema":1,"sha":"87710b7f93b8f7f00169b876395bb0d375f2e801","dirty":false}
1
+ {"schema":1,"sha":"919e4d4278360f14676fd6bb415f49336d7d7729","dirty":false}
@@ -1688,6 +1688,6 @@
1688
1688
  "status": 0,
1689
1689
  "signal": null,
1690
1690
  "stdout": "v24.3.0\n",
1691
- "stderr": "(node:14895) ExperimentalWarning: SQLite is an experimental feature and might change at any time\n(Use `node --trace-warnings ...` to show where the warning was created)\n"
1691
+ "stderr": "(node:15253) ExperimentalWarning: SQLite is an experimental feature and might change at any time\n(Use `node --trace-warnings ...` to show where the warning was created)\n"
1692
1692
  }
1693
1693
  }
@@ -37628,7 +37628,7 @@ var init_constants = __esm({
37628
37628
  "packages/client/src/constants.ts"() {
37629
37629
  "use strict";
37630
37630
  PACKAGE_NAME = "robisie";
37631
- PACKAGE_VERSION = "0.4.5";
37631
+ PACKAGE_VERSION = "0.4.7";
37632
37632
  SUPPORTED_CONTRACT_MAJOR = 1;
37633
37633
  DEFAULT_ORIGIN = "https://robisie.app";
37634
37634
  MCP_SERVER_NAME = "robisie";
@@ -37813,6 +37813,20 @@ function textList(value, path34, label2) {
37813
37813
  if (!Array.isArray(value) || !value.length) fail(label2, `${path34}: wymagana niepusta tablica tekst\xF3w`);
37814
37814
  return value.map((item, index2) => text2(item, `${path34}[${index2}]`, label2));
37815
37815
  }
37816
+ function parseReceiver(raw, requiredChecks, label2) {
37817
+ if (!raw || typeof raw !== "object" || Array.isArray(raw)) fail(label2, "engine.receiver: wymagany kompletny obiekt {githubRepo, verifyCheck, deployWorkflow}");
37818
+ const value = raw;
37819
+ const keys2 = ["githubRepo", "verifyCheck", "deployWorkflow"];
37820
+ if (Object.keys(value).some((key) => !keys2.includes(key))) fail(label2, "engine.receiver: nieznane pole");
37821
+ const githubRepo = text2(value.githubRepo, "engine.receiver.githubRepo", label2);
37822
+ const verifyCheck = text2(value.verifyCheck, "engine.receiver.verifyCheck", label2);
37823
+ const deployWorkflow = text2(value.deployWorkflow, "engine.receiver.deployWorkflow", label2);
37824
+ if (!/^[\w-]+\/[\w.-]+$/.test(githubRepo) || githubRepo.split("/").some((part) => part === "." || part === "..")) fail(label2, "engine.receiver.githubRepo: wymagane owner/repo bez URL i credentials");
37825
+ if (!/^\.github\/workflows\/[\w.-]+\.ya?ml$/.test(deployWorkflow) || deployWorkflow.includes("..")) fail(label2, "engine.receiver.deployWorkflow: wymagana \u015Bcie\u017Cka .github/workflows/*.yml|yaml bez ..");
37826
+ if (/[\x00-\x1f\x7f-\x9f]/.test(verifyCheck)) fail(label2, "engine.receiver.verifyCheck: znaki steruj\u0105ce niedozwolone");
37827
+ if (!requiredChecks.includes(verifyCheck)) fail(label2, "engine.receiver.verifyCheck: musi nale\u017Ce\u0107 do engine.requiredChecks");
37828
+ return { githubRepo, verifyCheck, deployWorkflow };
37829
+ }
37816
37830
  function parseEngineConfig(raw, configPath) {
37817
37831
  const config2 = parseConfig(raw, (0, import_node_path2.resolve)(configPath));
37818
37832
  const label2 = config2.configPath;
@@ -37828,7 +37842,14 @@ function parseEngineConfig(raw, configPath) {
37828
37842
  const build = textList(commands.build, "engine.commands.build", label2);
37829
37843
  const requiredChecks = value.delivery === "local" && Array.isArray(value.requiredChecks) && !value.requiredChecks.length ? [] : textList(value.requiredChecks, "engine.requiredChecks", label2);
37830
37844
  if (value.delivery !== "delivered" && value.delivery !== "pr" && value.delivery !== "local") fail(label2, "engine.delivery: wymagane delivered|pr|local");
37831
- return { ...config2, engine: { repo, branch, commands: { test, lint, build }, requiredChecks, delivery: value.delivery } };
37845
+ return { ...config2, engine: {
37846
+ repo,
37847
+ branch,
37848
+ commands: { test, lint, build },
37849
+ requiredChecks,
37850
+ delivery: value.delivery,
37851
+ ...Object.hasOwn(value, "receiver") ? { receiver: parseReceiver(value.receiver, requiredChecks, label2) } : {}
37852
+ } };
37832
37853
  }
37833
37854
  function loadEngineConfig(path34) {
37834
37855
  const { raw, configPath } = readConfig(path34);
@@ -55151,6 +55172,11 @@ function fromFile(file3, origin) {
55151
55172
  const mode = raw.engine.mode;
55152
55173
  if (mode !== void 0 && mode !== "client" && mode !== "host") throw new Error(`${configPath}: engine.mode: gdy podane \u2014 client|host`);
55153
55174
  const { engine } = config2;
55175
+ if (engine.receiver) {
55176
+ if (mode !== "host" || engine.delivery === "local") throw new Error(`${configPath}: engine.receiver: wymagany jawny mode:host i delivery:pr|delivered`);
55177
+ if (engine.branch !== BRANCH || Object.keys(RECEIVER).some((key) => engine.receiver[key] !== RECEIVER[key]))
55178
+ throw new Error(`${configPath}: engine.receiver: nieobs\u0142ugiwany odbiorca lub ga\u0142\u0105\u017A hosta`);
55179
+ }
55154
55180
  const hostStateDir2 = import_node_path15.default.join(config2.stateDir, "host");
55155
55181
  return {
55156
55182
  source: "file",
@@ -55163,7 +55189,7 @@ function fromFile(file3, origin) {
55163
55189
  tracks: config2.tracks.map((track) => ({ ...track })),
55164
55190
  defaultTrackLabel: DEFAULT_TRACK_LABEL,
55165
55191
  requiredChecks: [...engine.requiredChecks],
55166
- receiver: null,
55192
+ receiver: engine.receiver ? { ...engine.receiver } : null,
55167
55193
  delivery: engine.delivery,
55168
55194
  commands: { test: [...engine.commands.test], lint: [...engine.commands.lint], build: [...engine.commands.build] },
55169
55195
  stateDir: config2.stateDir,
@@ -75627,6 +75653,12 @@ function fetchCi(sha5, repo) {
75627
75653
  try {
75628
75654
  if (!shaValid(sha5)) throw new Error("niepoprawny SHA");
75629
75655
  const gh = receiverGithub(), target = gh.branch;
75656
+ if (currentEngine().source === "file") {
75657
+ const remote = (0, import_node_child_process7.execFileSync)("git", ["remote", "get-url", engineRemote()], { cwd: repo, encoding: "utf8", timeout: 1e4, stdio: "pipe" }).trim();
75658
+ const match = remote.match(/^(?:git@github\.com:|https:\/\/github\.com\/|ssh:\/\/git@github\.com\/)([\w.-]+)\/([\w.-]+?)(?:\.git)?\/?$/);
75659
+ if (!match || [match[1], match[2]].join("/").toLowerCase() !== gh.githubRepo.toLowerCase())
75660
+ throw new Error("repozytorium GitHub remote nie zgadza si\u0119 z engine.receiver.githubRepo");
75661
+ }
75630
75662
  const api = (endpoint) => {
75631
75663
  const pages2 = JSON.parse((0, import_node_child_process7.execFileSync)(
75632
75664
  "gh",
@@ -76220,7 +76252,7 @@ async function activePhase(o) {
76220
76252
  if (!policy.enabled || o.dry) return;
76221
76253
  const stopped = (0, import_node_fs18.existsSync)(import_node_path21.default.join(hostStateDir2, "receiver-stop"));
76222
76254
  if (stopped) o.log("odbiorca: STOP (receiver-stop)");
76223
- const loaded = readLoadedSha(o.repo);
76255
+ const loaded = readLoadedSha(ENGINE_CODE_REPO);
76224
76256
  if (!/^[a-f0-9]{40}$/i.test(loaded)) return;
76225
76257
  const q = await Promise.resolve().then(() => (init_q_planner(), q_planner_exports));
76226
76258
  const cards = await q.listTasks(o.uid, o.projectId, {
@@ -324319,7 +324351,7 @@ async function main2() {
324319
324351
  if (clientStopped()) return 2;
324320
324352
  await localAcceptancePhase(s, uid, DRY2, processCards.get(s), installation);
324321
324353
  } else {
324322
- await receiverPhase({ uid, projectId: projectId2, repo: REPO, dir: DIR, dry: DRY2, log: log2, snapshot: processCards.get(s) });
324354
+ await receiverPhase({ uid, projectId: projectId2, repo: TASK_REPO, dir: DIR, dry: DRY2, log: log2, snapshot: processCards.get(s) });
324323
324355
  await testerPhase(s, uid, projectId2, DRY2, loadedSha, processCards.get(s));
324324
324356
  }
324325
324357
  if (decisionCards) {
@@ -57,6 +57,12 @@ export interface EngineConfig extends InstanceConfig {
57
57
  requiredChecks: string[];
58
58
  /** `local` = wynik zostaje w repo docelowym (bez PR i bez dostarczenia); sam odczyt nic nie uruchamia. */
59
59
  delivery: 'delivered' | 'pr' | 'local';
60
+ /** Jawny opt-in odbiorcy hosta; brak zachowuje dotychczasową odmowę. */
61
+ receiver?: {
62
+ githubRepo: string;
63
+ verifyCheck: string;
64
+ deployWorkflow: string;
65
+ };
60
66
  };
61
67
  }
62
68
  export declare const CONFIG_FILE = "robisie.config.json";
@@ -113,6 +113,26 @@ function textList(value, path, label) {
113
113
  fail(label, `${path}: wymagana niepusta tablica tekstów`);
114
114
  return value.map((item, index) => text(item, `${path}[${index}]`, label));
115
115
  }
116
+ function parseReceiver(raw, requiredChecks, label) {
117
+ if (!raw || typeof raw !== 'object' || Array.isArray(raw))
118
+ fail(label, 'engine.receiver: wymagany kompletny obiekt {githubRepo, verifyCheck, deployWorkflow}');
119
+ const value = raw;
120
+ const keys = ['githubRepo', 'verifyCheck', 'deployWorkflow'];
121
+ if (Object.keys(value).some(key => !keys.includes(key)))
122
+ fail(label, 'engine.receiver: nieznane pole');
123
+ const githubRepo = text(value.githubRepo, 'engine.receiver.githubRepo', label);
124
+ const verifyCheck = text(value.verifyCheck, 'engine.receiver.verifyCheck', label);
125
+ const deployWorkflow = text(value.deployWorkflow, 'engine.receiver.deployWorkflow', label);
126
+ if (!/^[\w-]+\/[\w.-]+$/.test(githubRepo) || githubRepo.split('/').some(part => part === '.' || part === '..'))
127
+ fail(label, 'engine.receiver.githubRepo: wymagane owner/repo bez URL i credentials');
128
+ if (!/^\.github\/workflows\/[\w.-]+\.ya?ml$/.test(deployWorkflow) || deployWorkflow.includes('..'))
129
+ fail(label, 'engine.receiver.deployWorkflow: wymagana ścieżka .github/workflows/*.yml|yaml bez ..');
130
+ if (/[\x00-\x1f\x7f-\x9f]/.test(verifyCheck))
131
+ fail(label, 'engine.receiver.verifyCheck: znaki sterujące niedozwolone');
132
+ if (!requiredChecks.includes(verifyCheck))
133
+ fail(label, 'engine.receiver.verifyCheck: musi należeć do engine.requiredChecks');
134
+ return { githubRepo, verifyCheck, deployWorkflow };
135
+ }
116
136
  export function parseEngineConfig(raw, configPath) {
117
137
  const config = parseConfig(raw, resolve(configPath));
118
138
  const label = config.configPath;
@@ -131,7 +151,8 @@ export function parseEngineConfig(raw, configPath) {
131
151
  const requiredChecks = value.delivery === 'local' && Array.isArray(value.requiredChecks) && !value.requiredChecks.length ? [] : textList(value.requiredChecks, 'engine.requiredChecks', label);
132
152
  if (value.delivery !== 'delivered' && value.delivery !== 'pr' && value.delivery !== 'local')
133
153
  fail(label, 'engine.delivery: wymagane delivered|pr|local');
134
- return { ...config, engine: { repo, branch, commands: { test, lint, build }, requiredChecks, delivery: value.delivery } };
154
+ return { ...config, engine: { repo, branch, commands: { test, lint, build }, requiredChecks, delivery: value.delivery,
155
+ ...(Object.hasOwn(value, 'receiver') ? { receiver: parseReceiver(value.receiver, requiredChecks, label) } : {}) } };
135
156
  }
136
157
  export function loadEngineConfig(path) {
137
158
  const { raw, configPath } = readConfig(path);
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.4.5 \u2014 plik zarz\u0105dzany przez `npx robisie`; `npx robisie uninstall` go usunie -->";
20
+ export declare const MANAGED_LINE = "<!-- robisie:managed 0.4.7 \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;
@@ -55,6 +55,7 @@ od `roleProviders` instalatora dla ról `ceo`, `builder`, `quality`.
55
55
  "advisor": { "name": "Latarnia", "forms": ["Latarnia", "Latarni"] }
56
56
  },
57
57
  "engine": {
58
+ "mode": "host",
58
59
  "repo": "../repo with spaces",
59
60
  "branch": "main",
60
61
  "commands": {
@@ -62,13 +63,38 @@ od `roleProviders` instalatora dla ról `ceo`, `builder`, `quality`.
62
63
  "lint": ["npm", "run", "lint"],
63
64
  "build": ["npm", "run", "build:check"]
64
65
  },
65
- "requiredChecks": ["Test", "Lint", "Build"],
66
- "delivery": "pr"
66
+ "requiredChecks": ["Verify (lint + build:check)", "Lint", "Build"],
67
+ "delivery": "pr",
68
+ "receiver": {
69
+ "githubRepo": "chuppa12/robisie-app",
70
+ "verifyCheck": "Verify (lint + build:check)",
71
+ "deployWorkflow": ".github/workflows/deploy.yml"
72
+ }
67
73
  }
68
74
  }
69
75
  ```
70
76
  <!-- engine-config:json:end -->
71
77
 
78
+ ## Jawny odbiorca hosta
79
+
80
+ Przykład powyżej zawiera opcjonalny `engine.receiver` dla hosta Robisie.
81
+ Dla zwykłej instalacji usuń ten blok; jego brak zachowuje `receiver: null`.
82
+ Host bez pliku konfiguracji nadal korzysta z dotychczasowych ustawień.
83
+ Blok wymaga jawnego `engine.mode: "host"` i `delivery: "pr"` lub `"delivered"`.
84
+ Tryb `client` i dostawa `local` z tym blokiem kończą się błędem resolvera.
85
+ Obsługiwany jest wyłącznie pokazany odbiorca Robisie oraz gałąź `main`;
86
+ inne repo, check, workflow lub gałąź są jawnie nieobsługiwane.
87
+ Parser wymaga wszystkich trzech niepustych pól i odrzuca nieznane klucze.
88
+ `githubRepo` to samo `owner/repo`, bez URL i danych uwierzytelniających.
89
+ `deployWorkflow` to `.github/workflows/*.yml|yaml`, bez `..` i podkatalogów.
90
+ `verifyCheck` nie może zawierać znaków sterujących i musi być w `requiredChecks`.
91
+ Przed odczytem CI odbiorca sprawdza GitHub remote repozytorium `engine.repo`;
92
+ rozjazd, brak dostępu lub remote poza GitHub daje BRAK-DOWODU przed `gh`.
93
+ Ancestry i GitHub korzystają z repo zadań, a loaded z tożsamości kodu silnika
94
+ (w paczce: `engine/build-id.json`); HEAD repo zadań nie zastępuje loaded.
95
+ Ten blok wybiera źródło dowodu CI. Model, dostawca i niezależność odbiorcy
96
+ nadal podlegają osobnej polityce hosta. Odczyt konfiguracji niczego nie wdraża.
97
+
72
98
  ## Odczytaj plik
73
99
 
74
100
  W katalogu, w którym dostępna jest paczka `robisie` w `node_modules`, zapisz
package/docs/README.en.md CHANGED
@@ -1,4 +1,4 @@
1
- # robisie — from account to accepted card (package 0.4.5) <!-- x-release-please-version -->
1
+ # robisie — from account to accepted card (package 0.4.7) <!-- 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
 
@@ -53,7 +53,7 @@ Two distinct keys are required: A (`ROBISIE_KEY`, worker) and B (`ROBISIE_REVIEW
53
53
 
54
54
  A and B are stored separately in `${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key` and `review-key` (0600 files, 0700 directory). B never enters agent/model configuration, the manifest, arguments, claims or output. Load both environment variables, including with `--no-shell`. Run ordinary `npx robisie doctor` before the first task: `--engine-config` does not check keys. If A is missing or malformed, doctor diagnoses A; B checks begin only when A is present and has a valid format. Missing B, B=A, invalid format or failed B reads produce exit 1. B uses only `initialize` + `list_projects`, with no business-data mutations; auth counters may increase. Successful reads do not confirm role, a shared A/B account or project policy.
55
55
 
56
- Every doctor result includes `! Polityka enforced: NIE SPRAWDZONO — klient nie ma API jej odczytu.`: enforced policy: NOT CHECKED — the client has no API to read it. Project-context refusal happens before doctor and has its own advice. Green doctor does not activate enforced. For a B failure check Connect access and issuance as owner_validator; a network failure does not prove revocation. Retry init with correct B ENV, then doctor. Policy changes require a separate authorized operator action.
56
+ When key A sees exactly one project, doctor reads `reviewPolicy` via `list_projects`: `enforced` prints “✓ Polityka enforced: TAK”; `legacy` warns that `accept_review` will be refused and directs you to the operator. A missing/null server field prints “NIE SPRAWDZONO — serwer nie zwraca polityki”; a read failure prints “NIE SPRAWDZONO — odczyt nieudany”. This informational line does not change the exit code. Project-context refusal happens before doctor and has separate advice. The client only reads the policy; an authorized operator changes it.
57
57
 
58
58
  Polish CLI messages: `Brak klucza odbioru ROBISIE_REVIEW_KEY.` — Missing acceptance key ROBISIE_REVIEW_KEY.; `Klucz odbioru B jest tym samym tokenem co klucz A.` — Acceptance key B is the same token as key A.; `ROBISIE_REVIEW_KEY ma niepoprawny format.` — ROBISIE_REVIEW_KEY has an invalid format.; `Nie potwierdzono dostępu B do tablicy.` — Board access with key B could not be confirmed.; `Klucz B uwierzytelnia odczyt projektów.` — Key B authenticates project reads.
59
59
 
@@ -235,6 +235,54 @@ Doctor runs the helper file via node, the agent via npx. `ROBISIE_PROJECT_CONTEX
235
235
  <!-- sekcja: pierwsza-karta -->
236
236
  ## First card and Builder startup
237
237
 
238
+ ### Card for the local engine
239
+
240
+ Choose a project with policy `enforced` and `engine.delivery: "local"` using the [engine configuration](ENGINE-CONFIG.md). The CEO creates a card through the board tools with the literal `details` object below; the dashboard cannot edit `details`. Goal: change the greeting in an existing tracked `greet.cjs`; without arguments print `Witaj z fabryki`, and with one argument Ala, Bartek or Celina create a new `greeting.txt` containing `Witaj z fabryki, <name>!` and a trailing newline. No dependencies, accounts or publication. The code write scope is only `greet.cjs`; `greeting.txt` is a usage artifact in a separate worktree.
241
+
242
+ <!-- local-card-details:start -->
243
+ ```json
244
+ {
245
+ "card_class": "executable",
246
+ "delivery_mode": "local",
247
+ "scope": ["greet.cjs"],
248
+ "authority": "auto",
249
+ "done_when": ["greet.cjs wypisuje Witaj z fabryki i dla argumentów Ala, Bartek, Celina tworzy greeting.txt z dokładną treścią Witaj z fabryki, <imię>! oraz końcowym znakiem nowej linii"],
250
+ "effect_check": "{\"v\":1,\"source\":\"produkt/usage.jsonl\",\"criteria\":[0],\"min\":3,\"deadline\":\"2099-12-31T23:59:59Z\"}",
251
+ "seed_provenance": {"authoring_providers": {"by": "anthropic","proposal_by": "openai","packager_by": "anthropic"}}
252
+ }
253
+ ```
254
+ <!-- local-card-details:end -->
255
+
256
+ Before creating the card, replace the example `deadline` with a future ISO 8601 timestamp including a timezone and enough time for execution, the tester and three uses. In `seed_provenance.authoring_providers`, record the actual providers of the seed author (`by`), proposal author (`proposal_by`) and package author (`packager_by`); copying example providers does not establish independence. The engine supplies transport, delivery and tester results; do not manufacture these records.
257
+
258
+ After authorization, the CEO prepares the card as `ready`. Run `npx robisie factory run --engine-config ./robisie.config.json --once` and observe the card until a real tester PASS on the landed SHA and settlement (ACK): no `.tester-job.lock`, `.tester-job.input.json` or `.tester-job.result.json` in `stateDir`. PASS without ACK is insufficient.
259
+
260
+ Save the complete input below as `usage.json` in the current directory. Take `repo` from `engine.repo` and `stateDir` from engine configuration (resolve relative configuration paths against its directory; use absolute paths here). Copy `landed.sha` and `landed.at` from a fresh read of this card's `details.landed`; the values below are fictitious. Copy `source` and `deadline` from the JSON text in `details.effect_check`; `source` is relative to `stateDir/evidence`.
261
+
262
+ <!-- local-usage-input:start -->
263
+ ```json
264
+ {
265
+ "repo": "/sciezka/do/repo",
266
+ "stateDir": "/sciezka/do/stanu",
267
+ "landed": {"sha": "0123456789abcdef0123456789abcdef01234567","at": "2026-11-10T12:00:00Z"},
268
+ "source": "produkt/usage.jsonl",
269
+ "deadline": "2099-12-31T23:59:59Z",
270
+ "operation": "powitanie:Ala",
271
+ "program": {"entry": "greet.cjs","args": ["Ala"],"artifact": "greeting.txt"}
272
+ }
273
+ ```
274
+ <!-- local-usage-input:end -->
275
+
276
+ ```sh
277
+ npx robisie usage --input ./usage.json
278
+ ```
279
+
280
+ Success prints one JSON `UsageEvent` with exit 0. Change `operation` to `powitanie:Bartek` and `program.args` to `["Bartek"]`, run the same command, then repeat with `powitanie:Celina` and `["Celina"]`. The equivalent `--input=./usage.json` form is supported. Three distinct operations and distinct artifact bytes are required; three identical operations do not count as three. Do not append events manually. The CLI executes the landed SHA in a separate worktree; it does not judge the result or set `done`.
281
+
282
+ Refusal or IO failure returns exit 1 and a next step. An entry may already exist: inspect `stateDir/evidence/<source>` and the referenced artifacts before retrying, preserve evidence and resolve the cause. Never retry the program automatically. After three accepted uses, another `factory run --once` tick starts/settles independent acceptance; only a fresh card read confirms `local_receiver.outcome=PASS` and `status=done`. The package fixture does not prove actual customer use.
283
+
284
+ ### Manual Builder card
285
+
238
286
  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:
239
287
 
240
288
  > 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.
@@ -265,7 +313,7 @@ OpenCode: the card stays in `in_review` regardless of the availability of the Ag
265
313
 
266
314
  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.
267
315
 
268
- 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.
316
+ 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 manual wynik.txt card, 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.
269
317
 
270
318
  ### Blocked card: retry or abandon
271
319
 
package/docs/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # robisie — od konta do odebranej karty (paczka 0.4.5) <!-- x-release-please-version -->
1
+ # robisie — od konta do odebranej karty (paczka 0.4.7) <!-- 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
 
@@ -55,7 +55,7 @@ Wymagane są dwa osobne klucze: A (`ROBISIE_KEY`, worker) i B (`ROBISIE_REVIEW_K
55
55
 
56
56
  A i B są zapisywane osobno w `${XDG_CONFIG_HOME:-$HOME/.config}/robisie/key` i `review-key` (pliki 0600, katalog 0700). B nie trafia do konfiguracji agentów/modeli, manifestu, argumentów, claimów ani komunikatów. Załaduj oba ENV także przy `--no-shell`. Przed pierwszym zadaniem uruchom zwykły `npx robisie doctor`: tryb `--engine-config` nie sprawdza kluczy. Przy brakującym lub niepoprawnym A doctor diagnozuje A; sprawdzanie B zaczyna dopiero, gdy A jest obecny i ma poprawny format. Brak B, B=A, zły format i nieudany odczyt B dają exit 1. B sprawdzane jest przez `initialize` + `list_projects`, bez mutacji danych biznesowych; liczniki auth mogą wzrosnąć. Odczyt nie potwierdza roli, wspólnego konta A/B ani polityki projektu.
57
57
 
58
- Każdy wynik doctor zawiera `! Polityka enforced: NIE SPRAWDZONO — klient nie ma API jej odczytu.` Odmowa kontekstu projektu następuje przed doctor i ma własną poradę. Zielony doctor nie oznacza aktywacji enforced. Przy błędzie B sprawdź dostęp do Connect i wystawienie owner_validator; awaria sieci nie dowodzi unieważnienia. Ponów init z poprawnym B w ENV, potem doctor. Zmiana polityki wymaga osobnej uprawnionej czynności operatora.
58
+ Gdy klucz A widzi dokładnie jeden projekt, doctor odczytuje jego `reviewPolicy` przez `list_projects`: `enforced` daje „✓ Polityka enforced: TAK”, `legacy` ostrzega, że `accept_review` będzie odmawiane i wymaga ustawienia enforced przez operatora. Starszy serwer bez pola lub `null` daje „NIE SPRAWDZONO — serwer nie zwraca polityki”, błąd odczytu — „NIE SPRAWDZONO — odczyt nieudany”. Linia jest informacyjna i nie zmienia exit. Odmowa kontekstu projektu następuje przed doctor i ma własną poradę. Klient tylko odczytuje politykę, nie aktywuje enforced; zmienia ją uprawniony operator.
59
59
 
60
60
  ### Logowanie kodem: npx robisie login
61
61
 
@@ -280,6 +280,54 @@ Doctor uruchamia plik pomocnika przez node, agent przez npx. `ROBISIE_PROJECT_CO
280
280
  <!-- sekcja: pierwsza-karta -->
281
281
  ## Pierwsza karta i start Buildera
282
282
 
283
+ ### Karta dla lokalnego silnika
284
+
285
+ Wybierz projekt z polityką `enforced` i konfiguracją `engine.delivery: "local"` według [konfiguracji silnika](ENGINE-CONFIG.md). CEO tworzy kartę przez narzędzia tablicy, z poniższym literalnym obiektem `details`. Panel nie edytuje `details`. Cel: zmień powitanie w istniejącym, śledzonym `greet.cjs`; bez argumentu wypisz `Witaj z fabryki`, a dla jednego argumentu Ala, Bartek lub Celina zapisz nowe `greeting.txt` z `Witaj z fabryki, <imię>!` i końcowym znakiem nowej linii. Bez zależności, kont i publikacji. Zakres zapisu kodu obejmuje tylko `greet.cjs`; `greeting.txt` jest artefaktem użycia w osobnym worktree.
286
+
287
+ <!-- local-card-details:start -->
288
+ ```json
289
+ {
290
+ "card_class": "executable",
291
+ "delivery_mode": "local",
292
+ "scope": ["greet.cjs"],
293
+ "authority": "auto",
294
+ "done_when": ["greet.cjs wypisuje Witaj z fabryki i dla argumentów Ala, Bartek, Celina tworzy greeting.txt z dokładną treścią Witaj z fabryki, <imię>! oraz końcowym znakiem nowej linii"],
295
+ "effect_check": "{\"v\":1,\"source\":\"produkt/usage.jsonl\",\"criteria\":[0],\"min\":3,\"deadline\":\"2099-12-31T23:59:59Z\"}",
296
+ "seed_provenance": {"authoring_providers": {"by": "anthropic","proposal_by": "openai","packager_by": "anthropic"}}
297
+ }
298
+ ```
299
+ <!-- local-card-details:end -->
300
+
301
+ Przed utworzeniem karty zastąp przykładowy `deadline` przyszłym terminem ISO 8601 ze strefą czasową, obejmującym wykonanie, testera i trzy użycia. W `seed_provenance.authoring_providers` wpisz prawdziwych dostawców autorów: `by` autora zasiewu, `proposal_by` autora propozycji, `packager_by` autora pakietu; nie kopiuj przykładowych nazw dla pozorowania niezależności. Silnik dopisuje transport, dostawę i wynik testera — nie twórz tych dowodów ręcznie.
302
+
303
+ Po autoryzacji CEO przygotowuje kartę do `ready`. Uruchamiaj `npx robisie factory run --engine-config ./robisie.config.json --once` i obserwuj kartę aż do rzeczywistego PASS testera na landed SHA oraz jego rozliczenia (ACK): brak `.tester-job.lock`, `.tester-job.input.json` i `.tester-job.result.json` w `stateDir`. Sam PASS bez ACK nie wystarcza.
304
+
305
+ Zapisz poniższy pełny input jako `usage.json` w bieżącym katalogu. `repo` weź z `engine.repo`, a `stateDir` z konfiguracji silnika (ścieżki względne konfiguracji rozwiąż względem jej katalogu; tu użyj absolutnych). `landed.sha` i `landed.at` przepisz ze świeżego odczytu `details.landed` tej karty — poniższe wartości są fikcyjne. `source` i `deadline` przepisz z JSON w `details.effect_check`; `source` jest względem `stateDir/evidence`.
306
+
307
+ <!-- local-usage-input:start -->
308
+ ```json
309
+ {
310
+ "repo": "/sciezka/do/repo",
311
+ "stateDir": "/sciezka/do/stanu",
312
+ "landed": {"sha": "0123456789abcdef0123456789abcdef01234567","at": "2026-11-10T12:00:00Z"},
313
+ "source": "produkt/usage.jsonl",
314
+ "deadline": "2099-12-31T23:59:59Z",
315
+ "operation": "powitanie:Ala",
316
+ "program": {"entry": "greet.cjs","args": ["Ala"],"artifact": "greeting.txt"}
317
+ }
318
+ ```
319
+ <!-- local-usage-input:end -->
320
+
321
+ ```sh
322
+ npx robisie usage --input ./usage.json
323
+ ```
324
+
325
+ Po sukcesie otrzymasz jeden `UsageEvent` JSON i exit 0. Zmień `operation` na `powitanie:Bartek` oraz `program.args` na `["Bartek"]` i wykonaj to samo polecenie, potem analogicznie `powitanie:Celina` i `["Celina"]`. Możesz użyć równoważnego `--input=./usage.json`. Potrzebne są trzy różne operacje i różne bajty artefaktów; trzy identyczne operacje nie liczą się jako trzy. Nie dopisuj zdarzeń ręcznie. CLI wykonuje program na landed SHA w osobnym worktree, nie ocenia wyniku i nie ustawia `done`.
326
+
327
+ Przy odmowie lub błędzie IO polecenie zwraca exit 1 z następnym krokiem. Wpis może już istnieć: przed ponowieniem sprawdź `stateDir/evidence/<source>` oraz wskazane artefakty, zachowaj dowody i wyjaśnij przyczynę. Nie ponawiaj programu automatycznie. Po trzech przyjętych użyciach kolejny takt `factory run --once` uruchamia/rozlicza niezależny odbiór; dopiero świeży odczyt karty potwierdza `local_receiver.outcome=PASS` i `status=done`. Lokalny przykład w testach paczki nie dowodzi użycia u klienta.
328
+
329
+ ### Ręczna karta Buildera
330
+
283
331
  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:
284
332
 
285
333
  > 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.
@@ -310,7 +358,7 @@ OpenCode: karta pozostaje w `in_review` niezależnie od dostępności narzędzia
310
358
 
311
359
  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.
312
360
 
313
- 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.
361
+ 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 ręcznej karty wynik.txt 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.
314
362
 
315
363
  ### Karta zablokowana: ponów albo porzuć
316
364
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "robisie",
3
- "version": "0.4.5",
3
+ "version": "0.4.7",
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",