robisie 0.6.1 → 0.6.3
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 +17 -0
- package/dist/ci-failure-result.js +1 -1
- 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 +19 -9
- package/dist/roles.d.ts +1 -1
- package/docs/README.en.md +13 -1
- package/docs/README.md +13 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,22 @@
|
|
|
1
1
|
# Historia zmian klienta / Client changelog
|
|
2
2
|
|
|
3
|
+
## [0.6.3](https://github.com/chuppa12/robisie-app/compare/client-v0.6.2...client-v0.6.3) (2026-11-18)
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
### Factory Cards
|
|
7
|
+
|
|
8
|
+
* Padnięty krok Checkout w CI to awaria infrastruktury: jedno ponowienie, potem wstrzymanie karty bez rundy Workera ([8a9b086](https://github.com/chuppa12/robisie-app/commit/8a9b086c9bd879b10e5e25e930f8e57b1c1ec4d8))
|
|
9
|
+
|
|
10
|
+
## [0.6.2](https://github.com/chuppa12/robisie-app/compare/client-v0.6.1...client-v0.6.2) (2026-11-18)
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
### Factory Cards
|
|
14
|
+
|
|
15
|
+
* praca workera task-mwl9kqro-rmlcmo (auto-commit) ([3241a2b](https://github.com/chuppa12/robisie-app/commit/3241a2bffcc08f0469585944218586f2f613c10a))
|
|
16
|
+
* praca workera worker-d8ed3de0-963f-4deb-be95-e940b8b5e5c7 (auto-commit) ([124bf74](https://github.com/chuppa12/robisie-app/commit/124bf74205915f0c261633013a664d3e06294ac4))
|
|
17
|
+
* Przewodnik klienta w paczce mówi testerowi, co robić przy pierwszym HOLD, pustym wyniku użycia, liście z full, karcie-dokumencie oraz odmowie i HOLD bez nazwy przyczyny ([823e0cf](https://github.com/chuppa12/robisie-app/commit/823e0cf70c9a1196621e52f8070a61c5045d298a))
|
|
18
|
+
* Zgoda na aktualizacje zapisana w konfiguracji klienta nie unieważnia stampu pary kart w toku; zmiana roli albo pary dalej tak ([0ed55b0](https://github.com/chuppa12/robisie-app/commit/0ed55b06254febb590846c2af751916344d52f9b))
|
|
19
|
+
|
|
3
20
|
## [0.6.1](https://github.com/chuppa12/robisie-app/compare/client-v0.6.0...client-v0.6.1) (2026-11-17)
|
|
4
21
|
|
|
5
22
|
|
|
@@ -63,7 +63,7 @@ export function hasCiDiskHold(job) {
|
|
|
63
63
|
export function classifyCiFailure(failedJobs) {
|
|
64
64
|
if (failedJobs.length === 0)
|
|
65
65
|
return "unknown";
|
|
66
|
-
const hostStep = /^(Set up runner|Complete runner|Set up job|Complete job)$/;
|
|
66
|
+
const hostStep = /^(Set up runner|Complete runner|Set up job|Complete job|Checkout)$/;
|
|
67
67
|
let sawFailedStep = false;
|
|
68
68
|
let sawNotStartedJob = false;
|
|
69
69
|
let sawDisk = false;
|
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.6.
|
|
3
|
+
export declare const PACKAGE_VERSION = "0.6.3";
|
|
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.6.
|
|
3
|
+
export const PACKAGE_VERSION = "0.6.3"; // 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":"0801c2b8a86d6f45dabfec748c014b4fcc3aa9e0","dirty":false}
|
|
@@ -1725,6 +1725,6 @@
|
|
|
1725
1725
|
"status": 0,
|
|
1726
1726
|
"signal": null,
|
|
1727
1727
|
"stdout": "v24.3.0\n",
|
|
1728
|
-
"stderr": "(node:
|
|
1728
|
+
"stderr": "(node:23169) 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"
|
|
1729
1729
|
}
|
|
1730
1730
|
}
|
package/dist/engine/tick.cjs
CHANGED
|
@@ -37652,7 +37652,7 @@ var init_constants = __esm({
|
|
|
37652
37652
|
"packages/client/src/constants.ts"() {
|
|
37653
37653
|
"use strict";
|
|
37654
37654
|
PACKAGE_NAME = "robisie";
|
|
37655
|
-
PACKAGE_VERSION = "0.6.
|
|
37655
|
+
PACKAGE_VERSION = "0.6.3";
|
|
37656
37656
|
SUPPORTED_CONTRACT_MAJOR = 1;
|
|
37657
37657
|
DEFAULT_ORIGIN = "https://robisie.app";
|
|
37658
37658
|
MCP_SERVER_NAME = "robisie";
|
|
@@ -50267,7 +50267,7 @@ function hasCiDiskHold(job) {
|
|
|
50267
50267
|
}
|
|
50268
50268
|
function classifyCiFailure(failedJobs) {
|
|
50269
50269
|
if (failedJobs.length === 0) return "unknown";
|
|
50270
|
-
const hostStep = /^(Set up runner|Complete runner|Set up job|Complete job)$/;
|
|
50270
|
+
const hostStep = /^(Set up runner|Complete runner|Set up job|Complete job|Checkout)$/;
|
|
50271
50271
|
let sawFailedStep = false;
|
|
50272
50272
|
let sawNotStartedJob = false;
|
|
50273
50273
|
let sawDisk = false;
|
|
@@ -77341,6 +77341,12 @@ function selectClientPair(registry2, platform = process.platform) {
|
|
|
77341
77341
|
throw new ClientPairHold(error48 instanceof Error ? error48.message : "brak poprawnych r\xF3l Workera i recenzenta");
|
|
77342
77342
|
}
|
|
77343
77343
|
}
|
|
77344
|
+
function canonicalConfig(value, root = false) {
|
|
77345
|
+
if (typeof value === "number" && !Number.isFinite(value)) throw new Error("Niepoprawna liczba w konfiguracji");
|
|
77346
|
+
if (Array.isArray(value)) return value.map((item) => canonicalConfig(item));
|
|
77347
|
+
if (value && typeof value === "object") return Object.fromEntries(Object.entries(value).filter(([key]) => !root || key !== "update").sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, item]) => [key, canonicalConfig(item)]));
|
|
77348
|
+
return value;
|
|
77349
|
+
}
|
|
77344
77350
|
function loadClientPair(path34, platform = process.platform) {
|
|
77345
77351
|
try {
|
|
77346
77352
|
if (!path34) throw new ClientPairHold("brak \u015Bcie\u017Cki konfiguracji");
|
|
@@ -77348,10 +77354,12 @@ function loadClientPair(path34, platform = process.platform) {
|
|
|
77348
77354
|
const bytes = (0, import_node_fs21.readFileSync)(canonical4);
|
|
77349
77355
|
const raw = JSON.parse(bytes.toString("utf8").replace(/^\uFEFF/, ""));
|
|
77350
77356
|
parseEngineConfig(raw, canonical4);
|
|
77351
|
-
|
|
77352
|
-
|
|
77353
|
-
|
|
77354
|
-
|
|
77357
|
+
const selection = selectClientPair(parseRoleRegistry(raw, canonical4), platform);
|
|
77358
|
+
return { selection, config: Object.freeze({
|
|
77359
|
+
path: canonical4,
|
|
77360
|
+
sha256: (0, import_node_crypto11.createHash)("sha256").update(JSON.stringify(canonicalConfig(raw, true))).digest("hex"),
|
|
77361
|
+
legacySha256: (0, import_node_crypto11.createHash)("sha256").update(bytes).digest("hex")
|
|
77362
|
+
}) };
|
|
77355
77363
|
} catch (error48) {
|
|
77356
77364
|
if (error48 instanceof ClientPairHold) throw error48;
|
|
77357
77365
|
throw new ClientPairHold("nie mo\u017Cna odczyta\u0107 lub zweryfikowa\u0107 konfiguracji");
|
|
@@ -77384,6 +77392,7 @@ function freezeClientPair(selection, config2, worker) {
|
|
|
77384
77392
|
function assertClientPairMatches(value, selection, config2, worker) {
|
|
77385
77393
|
const expected = freezeClientPair(selection, config2, worker);
|
|
77386
77394
|
if ((0, import_node_util4.isDeepStrictEqual)(value, expected)) return;
|
|
77395
|
+
if (typeof config2.legacySha256 === "string" && /^[a-f0-9]{64}$/.test(config2.legacySha256) && (0, import_node_util4.isDeepStrictEqual)(value, { ...expected, config: { path: expected.config.path, sha256: config2.legacySha256 } })) return;
|
|
77387
77396
|
const section = (raw, shape, optional4 = {}) => {
|
|
77388
77397
|
if (!raw || typeof raw !== "object" || Array.isArray(raw)) return false;
|
|
77389
77398
|
const fields = raw;
|
|
@@ -80022,7 +80031,8 @@ function receiverSettings(settings, context) {
|
|
|
80022
80031
|
function loadClientReceiver(config2) {
|
|
80023
80032
|
try {
|
|
80024
80033
|
const bytes = (0, import_node_fs25.readFileSync)(config2.path);
|
|
80025
|
-
|
|
80034
|
+
const current = loadClientPair(config2.path).config;
|
|
80035
|
+
if (current.path !== config2.path || digest4(bytes) !== current.legacySha256 || config2.sha256 !== current.sha256 && config2.sha256 !== current.legacySha256) throw new Error("zmieniona konfiguracja odbiorcy");
|
|
80026
80036
|
const registry2 = parseRoleRegistry(JSON.parse(bytes.toString("utf8").replace(/^\uFEFF/, "")), config2.path);
|
|
80027
80037
|
validateClientRoles(registry2["worker-client"], registry2["reviewer-client"], registry2["receiver-client"]);
|
|
80028
80038
|
return registry2["receiver-client"];
|
|
@@ -80558,8 +80568,8 @@ function runLocalReceiverJob(dir, run) {
|
|
|
80558
80568
|
const p = claim.input.prepared;
|
|
80559
80569
|
try {
|
|
80560
80570
|
const loaded = loadClientPair(process.env.ROBISIE_ENGINE_CONFIG);
|
|
80561
|
-
|
|
80562
|
-
assertClientReceiver(p.clientReceiver,
|
|
80571
|
+
assertClientPairMatches(p.pair, loaded.selection, loaded.config, p.pair.actualWorker);
|
|
80572
|
+
assertClientReceiver(p.clientReceiver, p.pair.config);
|
|
80563
80573
|
localReceiverChoice(claim.input);
|
|
80564
80574
|
} catch (error48) {
|
|
80565
80575
|
response = { preparationError: failure2(error48) };
|
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.6.
|
|
20
|
+
export declare const MANAGED_LINE = "<!-- robisie:managed 0.6.3 \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.6.
|
|
1
|
+
# robisie — from account to accepted card (package 0.6.3) <!-- 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
|
|
|
@@ -406,6 +406,8 @@ After authorization, the CEO prepares the content and may promote the card to `r
|
|
|
406
406
|
|
|
407
407
|
A full read is `get_task({id, include:[], fullDetails:true})`: it already includes `test`, `landed` and `local_receiver`, without adding them to `include`. A `list_tasks` list needs explicit `detailsKeys` for the required details and omits `done` by default; check the result and completion by the known ID, not by disappearance from the list. Review is asynchronous and takes minutes; “Recenzja … trwa” means progress. STOP is a nonzero tick exit code, not a count of repeated messages. One format repair within the same acceptance job is normal and does not consume another budget position: `response.repair` and `repair.error` are in the archive referenced by `local_receiver.ref`.
|
|
408
408
|
|
|
409
|
+
A full list (full: true) requires detailsKeys. To omit details, pass detailsKeys: []. Plain full: true is an input error, not a board failure.
|
|
410
|
+
|
|
409
411
|
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 the exact `source` from the JSON text in `details.effect_check` into `usage.json`, without inventing a new path; copy `deadline` too. `source` is relative to `stateDir/evidence`.
|
|
410
412
|
|
|
411
413
|
<!-- local-usage-input:start -->
|
|
@@ -422,14 +424,22 @@ Save the complete input below as `usage.json` in the current directory. Take `re
|
|
|
422
424
|
```
|
|
423
425
|
<!-- local-usage-input:end -->
|
|
424
426
|
|
|
427
|
+
Before the first usage, distinguish WAIT (too few usages; waiting for a new event or deadline) from a generic receiver HOLD (reading or verifying evidence). The first accepted npx robisie usage does not guarantee that the next tick clears HOLD: resuming after the specific cause is resolved also requires the remaining evidence to be valid. WAIT may remain until min is met and acceptance is assessed. Do not retry the card and do not move the command to another session.
|
|
428
|
+
|
|
425
429
|
```sh
|
|
426
430
|
npx robisie usage --input ./usage.json
|
|
427
431
|
```
|
|
428
432
|
|
|
433
|
+
Run this in the same session where the factory runs, not in a sandbox that does not allow Node to start. Empty output and EPERM: STOP, one line (where, version, status, signal, error). Do not move the command to another session.
|
|
434
|
+
|
|
435
|
+
If the card's result is a document, report or text rather than a program, robisie usage will not close it. Do not add an artificial program to get through usage. Report the card as stalled for lack of a path for a document.
|
|
436
|
+
|
|
429
437
|
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 program in a copy of the landed SHA in a run directory under `stateDir`; it does not judge the result or set `done`.
|
|
430
438
|
|
|
431
439
|
Refusal or IO failure returns exit 1 and a next step. An entry may already exist: inspect `stateDir/evidence/<source>` and the referenced artifacts before retrying, preserve evidence and resolve the cause. Never retry the program automatically. After three accepted uses, another `factory run --once` tick starts/settles independent acceptance; only a fresh `get_task({id, include:[], fullDetails:true})` confirms `details.local_receiver.outcome=PASS` and `status=done`. The package fixture does not prove actual customer use.
|
|
432
440
|
|
|
441
|
+
The bare message „Odmowa użycia: Niepoprawny kontrakt JSON” does not name the field. Do not retry blindly. Report the missing field name.
|
|
442
|
+
|
|
433
443
|
Acceptance has three outcomes: PASS proceeds through independent acceptance recorded with key B to `done`; waiting keeps the card in “Awaiting acceptance” (“Do odbioru”); a blocking STOP moves it to “Blocked” (“Zablokowane”). Every job reaching the model consumes a budget position, including a job with a valid assessment. Without a valid assessment and with `n<3`, the card waits 30 minutes with `local_receiver.reason` containing the literal `zadanie n/3; najwcześniej <czas UTC>` (job n/3; not before <UTC time>); the tick has exit 0, and checking resumes on the first subsequent tick after that time. With `n>=3`, no valid assessment blocks the card. Returning does not reset the counter. `--once` needs another tick, including to settle the result; `factory run` without `--once` repeats ticks itself.
|
|
434
444
|
|
|
435
445
|
### Manual Builder card
|
|
@@ -466,6 +476,8 @@ In other CEO sessions, including Codex, moving to delivered requires independent
|
|
|
466
476
|
|
|
467
477
|
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.
|
|
468
478
|
|
|
479
|
+
The message „Nie można odczytać lub zweryfikować dowodów receivera” does not show the caught error. Do not guess the contract. If the card names a program, do the described usages and one tick. If the result is only a document, stand still.
|
|
480
|
+
|
|
469
481
|
### Blocked card: retry or abandon
|
|
470
482
|
|
|
471
483
|
A card in the “Blocked” stage waits for the owner's decision. The scope protection is intentional: the worker key A cannot close the card — setting `done` with key A is refused with 403. `done` is reserved for accepting a result with evidence, not for releasing scope. Do not broaden key A or change roles to bypass the refusal.
|
package/docs/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# robisie — od konta do odebranej karty (paczka 0.6.
|
|
1
|
+
# robisie — od konta do odebranej karty (paczka 0.6.3) <!-- 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
|
|
|
@@ -453,6 +453,8 @@ Po autoryzacji CEO przygotowuje treść i może promować kartę do `ready`; lok
|
|
|
453
453
|
|
|
454
454
|
Pełny odczyt to `get_task({id, include:[], fullDetails:true})`: zawiera już `test`, `landed` i `local_receiver`, bez dopisywania ich do `include`. Lista `list_tasks` wymaga jawnego `detailsKeys` dla potrzebnych szczegółów i domyślnie pomija `done`; wynik i zakończenie sprawdzaj po znanym ID, nie przez zniknięcie z listy. Recenzja jest asynchroniczna, trwa rzędu minut; „Recenzja … trwa” oznacza ruch. STOP rozpoznasz po niezerowym kodzie taktu, nie po liczbie powtórzeń komunikatu. Jedna naprawa formy w tym samym zadaniu odbioru jest normalna i nie jest kolejną pozycją budżetu: `response.repair` i `repair.error` znajdziesz w archiwum wskazanym przez `local_receiver.ref`.
|
|
455
455
|
|
|
456
|
+
Pełna lista (full: true) wymaga detailsKeys. Żeby pominąć szczegóły, podaj detailsKeys: []. Samo full: true jest błędem wejścia, nie awarią tablicy.
|
|
457
|
+
|
|
456
458
|
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. Do `usage.json` skopiuj dokładny `source` z JSON w `details.effect_check`, bez wymyślania nowej ścieżki; przepisz też `deadline`. `source` jest względem `stateDir/evidence`.
|
|
457
459
|
|
|
458
460
|
<!-- local-usage-input:start -->
|
|
@@ -469,14 +471,22 @@ Zapisz poniższy pełny input jako `usage.json` w bieżącym katalogu. `repo` we
|
|
|
469
471
|
```
|
|
470
472
|
<!-- local-usage-input:end -->
|
|
471
473
|
|
|
474
|
+
Przed pierwszym użyciem odróżnij WAIT (za mało użyć; oczekiwanie na nowe zdarzenie lub deadline) od ogólnego HOLD receivera (odczyt lub weryfikacja dowodów). Pierwsze przyjęte npx robisie usage nie gwarantuje zdjęcia HOLD w następnym takcie: wznowienie po usunięciu konkretnej przyczyny wymaga też poprawnych pozostałych dowodów. WAIT może pozostać do spełnienia min i oceny odbioru. Nie ponawiaj karty i nie przenoś polecenia do innej sesji.
|
|
475
|
+
|
|
472
476
|
```sh
|
|
473
477
|
npx robisie usage --input ./usage.json
|
|
474
478
|
```
|
|
475
479
|
|
|
480
|
+
Uruchom to w tej samej sesji, w której działa fabryka, nie w piaskownicy, która nie pozwala wystartować Node. Pusty wynik i EPERM: STOP, jedna linia (gdzie, wersja, status, signal, error). Nie przenoś polecenia do innej sesji.
|
|
481
|
+
|
|
482
|
+
Jeśli wynikiem karty jest dokument, raport albo tekst, a nie program, robisie usage jej nie domknie. Nie dopisuj sztucznego programu, żeby przejść użycie. Zgłoś kartę jako stojącą na braku drogi dla dokumentu.
|
|
483
|
+
|
|
476
484
|
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 w kopii landed SHA w katalogu przebiegu pod `stateDir`, nie ocenia wyniku i nie ustawia `done`.
|
|
477
485
|
|
|
478
486
|
Przy odmowie lub błędzie IO polecenie zwraca exit 1 z następnym krokiem. Wpis może już istnieć: przed ponowieniem sprawdź `stateDir/evidence/<source>` oraz wskazane artefakty, zachowaj dowody i wyjaśnij przyczynę. Nie ponawiaj programu automatycznie. Po trzech przyjętych użyciach kolejny takt `factory run --once` uruchamia/rozlicza niezależny odbiór; dopiero świeży `get_task({id, include:[], fullDetails:true})` potwierdza `details.local_receiver.outcome=PASS` i `status=done`. Lokalny przykład w testach paczki nie dowodzi użycia u klienta.
|
|
479
487
|
|
|
488
|
+
Sam napis „Odmowa użycia: Niepoprawny kontrakt JSON” nie nazywa pola. Nie ponawiaj na ślepo. Zgłoś brak nazwy pola.
|
|
489
|
+
|
|
480
490
|
Odbiór ma trzy wyniki: PASS prowadzi przez niezależny zapis odbioru kluczem B do `done`; oczekiwanie pozostawia kartę w „Do odbioru”; STOP blokujący przenosi ją do „Zablokowane”. Każde zadanie dochodzące do modelu zużywa pozycję budżetu, także zadanie z ważną oceną. Przy braku ważnej oceny i `n<3` karta czeka 30 minut, z `local_receiver.reason` zawierającym `zadanie n/3; najwcześniej <czas UTC>`; takt ma exit 0, a pierwsze sprawdzenie następuje w pierwszym kolejnym takcie po tym czasie. Przy `n>=3` brak ważnej oceny blokuje kartę. Powrót nie zeruje licznika. `--once` wymaga uruchomienia kolejnego taktu także do rozliczenia wyniku; `factory run` bez `--once` ponawia takty samo.
|
|
481
491
|
|
|
482
492
|
### Start CEO i Buildera
|
|
@@ -512,6 +522,8 @@ Automatyczny cykl lokalny wymaga aktywnej instalacji z `engine.delivery: "local"
|
|
|
512
522
|
|
|
513
523
|
**Ręczny przykład `wynik.txt` jest niewspierany przez rolę `ceo-client`.** Pozytywna recenzja nie zapewnia mu drogi do odbioru: bez `local_receiver.outcome=PASS` automat nie przenosi karty z `in_review` do `delivered`, a CEO nie może ustawiać `delivered` ani `done`. Sam opis kliknięcia `delivered → done` w panelu nie uzupełnia tego brakującego przejścia ani nie zastępuje chronionego odbioru przy polityce `enforced`. Dla roli CEO wybierz kompletną lokalną kartę `greet.cjs` opisaną wyżej, z wymaganymi dowodami i rzeczywistymi użyciami; bez nich nazwij brak i eskaluj, bez ręcznej zmiany statusu. Ten opis nie dowodzi użycia u klienta.
|
|
514
524
|
|
|
525
|
+
Napis „Nie można odczytać lub zweryfikować dowodów receivera” nie podaje złapanego błędu. Nie zgaduj umowy. Jeśli karta nazywa program, zrób opisane użycia i jeden takt. Jeśli wynikiem jest sam dokument, stój.
|
|
526
|
+
|
|
515
527
|
### Karta zablokowana: ponów albo porzuć
|
|
516
528
|
|
|
517
529
|
Karta w etapie „Zablokowane” czeka na decyzję właściciela. Ochrona zakresu jest celowa: klucz roboczy A (worker) nie zamknie karty — próba ustawienia `done` kluczem A kończy się odmową 403. `done` jest zarezerwowane dla odbioru wyniku z dowodem, nie do zwalniania zakresu. Nie rozszerzaj klucza A ani nie zmieniaj ról, żeby obejść odmowę.
|
package/package.json
CHANGED