robisie 0.4.6 → 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 +7 -0
- package/README.md +3 -1
- package/dist/cli.d.ts +1 -0
- package/dist/cli.js +41 -2
- package/dist/constants.d.ts +1 -1
- package/dist/constants.js +1 -1
- package/dist/engine/build-id.json +1 -1
- package/dist/engine/bundle-report.json +1 -1
- package/dist/engine/tick.cjs +1 -1
- package/dist/roles.d.ts +1 -1
- package/docs/README.en.md +51 -3
- package/docs/README.md +51 -3
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
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
|
+
|
|
3
10
|
## [0.4.6](https://github.com/chuppa12/robisie-app/compare/client-v0.4.5...client-v0.4.6) (2026-11-10)
|
|
4
11
|
|
|
5
12
|
|
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
|
-
|
|
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
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
|
-
|
|
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;
|
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.4.
|
|
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.
|
|
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":"
|
|
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:
|
|
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
|
}
|
package/dist/engine/tick.cjs
CHANGED
|
@@ -37628,7 +37628,7 @@ var init_constants = __esm({
|
|
|
37628
37628
|
"packages/client/src/constants.ts"() {
|
|
37629
37629
|
"use strict";
|
|
37630
37630
|
PACKAGE_NAME = "robisie";
|
|
37631
|
-
PACKAGE_VERSION = "0.4.
|
|
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";
|
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.
|
|
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;
|
package/docs/README.en.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# robisie — from account to accepted card (package 0.4.
|
|
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
|
-
|
|
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
|
|
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.
|
|
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
|
-
|
|
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
|
|
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