robisie 0.5.41 → 0.5.43
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 +27 -0
- package/dist/constants.d.ts +1 -1
- package/dist/constants.js +1 -1
- package/dist/delivery-local.d.ts +9 -3
- package/dist/delivery-local.js +25 -3
- package/dist/engine/build-id.json +1 -1
- package/dist/engine/bundle-report.json +290 -278
- package/dist/engine/tick.cjs +1110 -851
- package/dist/local-usage.js +71 -28
- package/dist/mcp.d.ts +1 -1
- package/dist/mcp.js +17 -3
- package/dist/roles.d.ts +1 -1
- package/dist/roles.js +1 -0
- package/dist/tester-result-reader.d.ts +7 -0
- package/dist/tester-result-reader.js +7 -0
- package/docs/README.en.md +3 -3
- package/docs/README.md +3 -3
- package/package.json +1 -1
package/dist/local-usage.js
CHANGED
|
@@ -1,12 +1,14 @@
|
|
|
1
1
|
import { spawnSync } from "node:child_process";
|
|
2
2
|
import { createHash, randomUUID } from "node:crypto";
|
|
3
|
-
import { closeSync, fsyncSync, fstatSync, lstatSync, mkdirSync, mkdtempSync, openSync, readSync, realpathSync, renameSync,
|
|
3
|
+
import { closeSync, fsyncSync, fstatSync, lstatSync, mkdirSync, mkdtempSync, openSync, readlinkSync, readSync, realpathSync, renameSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
|
|
4
4
|
import path from "node:path";
|
|
5
5
|
import { z } from "zod";
|
|
6
6
|
const text = z.string().trim().min(1), at = z.iso.datetime({ offset: true });
|
|
7
7
|
const eventSchema = z.strictObject({ id: text, at, sha: z.string().regex(/^[a-f0-9]{40}$/), ref: text, operation: text, result: text });
|
|
8
8
|
const digest = (v) => createHash("sha256").update(v).digest("hex");
|
|
9
|
-
const failure = (e) => e instanceof z.ZodError ? "Niepoprawny kontrakt JSON"
|
|
9
|
+
const failure = (e) => e instanceof z.ZodError ? "Niepoprawny kontrakt JSON"
|
|
10
|
+
: e instanceof Error && "code" in e && e.code ? `${String(e.code)}: ${e.message}` : String(e);
|
|
11
|
+
const cleanExit = (r) => r.status === 0 && r.signal === null;
|
|
10
12
|
export function relative(ref) {
|
|
11
13
|
if (path.isAbsolute(ref) || ref.split(/[\\/]/).some(p => p === ".." || p === "") || ref.includes("\0"))
|
|
12
14
|
throw new Error("Obca ścieżka dowodu");
|
|
@@ -108,15 +110,15 @@ function owned(root, file) {
|
|
|
108
110
|
/** One synchronous Node invocation; no shell, card commands, inherited credentials or control env. */
|
|
109
111
|
export function runLocalUsage(input) {
|
|
110
112
|
let stage = "wejście", published = false, lock, pending;
|
|
111
|
-
let root, run,
|
|
113
|
+
let root, run, result;
|
|
112
114
|
const errors = [];
|
|
113
115
|
// Deliberately small environment; no HOME/config, NODE_OPTIONS, GIT_* or Planner credentials from the caller.
|
|
114
116
|
// The host Next.js types require NODE_ENV; this Node-only child intentionally omits it.
|
|
115
117
|
const env = { PATH: "/usr/bin:/bin", LANG: "C.UTF-8" };
|
|
116
|
-
const git = (cwd, args) => {
|
|
117
|
-
const r = spawnSync("git", args, { cwd, env, encoding: "utf8", shell: false });
|
|
118
|
-
if (r
|
|
119
|
-
throw new Error(`git ${args[0]}: status=${r.status}, signal=${r.signal}: ${r.stderr ?? ""}`, { cause: r.error });
|
|
118
|
+
const git = (cwd, args, input) => {
|
|
119
|
+
const r = spawnSync("git", args, { cwd, env, input, encoding: "utf8", shell: false });
|
|
120
|
+
if (!cleanExit(r))
|
|
121
|
+
throw new Error(`git ${args[0]}: status=${r.status}, signal=${r.signal}: ${r.stderr ?? ""}${r.error ? `; error=${failure(r.error)}` : ""}`, { cause: r.error });
|
|
120
122
|
return r.stdout.trim();
|
|
121
123
|
};
|
|
122
124
|
try {
|
|
@@ -143,39 +145,82 @@ export function runLocalUsage(input) {
|
|
|
143
145
|
readLocalUsageEvents(root, { ...input, source: sourceRef, readAt: new Date().toISOString() });
|
|
144
146
|
previous = boundedBytes(source);
|
|
145
147
|
}
|
|
146
|
-
stage = "
|
|
148
|
+
stage = "SHA przed wykonaniem";
|
|
149
|
+
const verifyCommit = () => {
|
|
150
|
+
const sha = git(input.repo, ["rev-parse", "--verify", "--end-of-options", `${input.landed.sha}^{commit}`]);
|
|
151
|
+
if (sha !== input.landed.sha)
|
|
152
|
+
throw new Error("Obcy SHA użycia");
|
|
153
|
+
return sha;
|
|
154
|
+
};
|
|
155
|
+
const sha = verifyCommit();
|
|
147
156
|
run = mkdtempSync(path.join(directory(root, ".runs"), "usage-"));
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
157
|
+
const copy = path.join(run, "copy");
|
|
158
|
+
stage = "archiwum";
|
|
159
|
+
const archive = path.join(run, "landed.tar");
|
|
160
|
+
git(input.repo, ["archive", "--format=tar", `--output=${archive}`, sha]);
|
|
161
|
+
mkdirSync(copy, { mode: 0o700 });
|
|
162
|
+
const extracted = spawnSync("tar", ["-xf", archive, "-C", copy], { cwd: run, env, encoding: "utf8", shell: false });
|
|
163
|
+
if (!cleanExit(extracted))
|
|
164
|
+
throw new Error(`tar: status=${extracted.status}, signal=${extracted.signal}: ${extracted.stderr ?? ""}${extracted.error ? `; error=${failure(extracted.error)}` : ""}`, { cause: extracted.error });
|
|
165
|
+
stage = "drzewo";
|
|
166
|
+
const tree = new Map();
|
|
167
|
+
for (const record of git(input.repo, ["ls-tree", "-r", "-z", "--full-tree", sha]).split("\0").filter(Boolean)) {
|
|
168
|
+
const tab = record.indexOf("\t"), header = /^(100644|100755|120000) blob ([a-f0-9]{40})$/.exec(record.slice(0, tab));
|
|
169
|
+
if (tab < 0 || !header)
|
|
170
|
+
throw new Error("Nieobsługiwany typ śledzonego kodu użycia");
|
|
171
|
+
const ref = record.slice(tab + 1);
|
|
172
|
+
relative(ref);
|
|
173
|
+
tree.set(ref, { mode: header[1], blob: header[2] });
|
|
174
|
+
}
|
|
151
175
|
const verify = () => {
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
176
|
+
for (const [ref, { mode, blob }] of tree) {
|
|
177
|
+
const file = path.join(copy, ref), parent = path.dirname(ref);
|
|
178
|
+
if (realpathSync(copy) !== copy || (parent !== "." && within(copy, parent) !== path.dirname(file)))
|
|
179
|
+
throw new Error("Zmieniony katalog kodu użycia");
|
|
180
|
+
const stat = lstatSync(file, { throwIfNoEntry: false });
|
|
181
|
+
if (!stat)
|
|
182
|
+
throw new Error("Zmieniony śledzony kod użycia");
|
|
183
|
+
let actual;
|
|
184
|
+
if (mode === "120000" && stat.isSymbolicLink()) {
|
|
185
|
+
actual = git(input.repo, ["hash-object", "--stdin"], readlinkSync(file, { encoding: "buffer" }));
|
|
186
|
+
within(copy, ref);
|
|
187
|
+
}
|
|
188
|
+
else if (stat.isFile() && mode === (stat.mode & 0o111 ? "100755" : "100644")) {
|
|
189
|
+
actual = git(input.repo, ["hash-object", "--no-filters", "--", file]);
|
|
190
|
+
}
|
|
191
|
+
else
|
|
192
|
+
throw new Error("Zmieniony śledzony kod użycia");
|
|
193
|
+
if (actual !== blob)
|
|
194
|
+
throw new Error("Zmieniony śledzony kod użycia");
|
|
195
|
+
}
|
|
156
196
|
};
|
|
157
|
-
stage = "
|
|
197
|
+
stage = "weryfikacja przed wykonaniem";
|
|
158
198
|
verify();
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
const
|
|
199
|
+
if (!tree.has(input.program.entry))
|
|
200
|
+
throw new Error("Nieśledzony program użycia");
|
|
201
|
+
const entry = within(copy, input.program.entry);
|
|
202
|
+
if (!tree.has(path.relative(copy, entry)))
|
|
203
|
+
throw new Error("Nieśledzony program użycia");
|
|
204
|
+
const artifact = destination(copy, input.program.artifact);
|
|
162
205
|
if (lstatSync(artifact, { throwIfNoEntry: false }))
|
|
163
206
|
throw new Error("Artefakt istnieje przed użyciem");
|
|
164
207
|
stage = "proces";
|
|
165
|
-
const executed = spawnSync(process.execPath, [entry, ...input.program.args], { cwd:
|
|
208
|
+
const executed = spawnSync(process.execPath, [entry, ...input.program.args], { cwd: copy, env, encoding: "utf8", shell: false });
|
|
166
209
|
const finishedAt = new Date().toISOString();
|
|
167
|
-
if (executed
|
|
168
|
-
throw new Error(`Proces użycia: status=${executed.status}, signal=${executed.signal}; stdout=${executed.stdout ?? ""}; stderr=${executed.stderr ?? ""}`, { cause: executed.error });
|
|
169
|
-
stage = "
|
|
210
|
+
if (!cleanExit(executed))
|
|
211
|
+
throw new Error(`Proces użycia: status=${executed.status}, signal=${executed.signal}; stdout=${executed.stdout ?? ""}; stderr=${executed.stderr ?? ""}${executed.error ? `; error=${failure(executed.error)}` : ""}`, { cause: executed.error });
|
|
212
|
+
stage = "weryfikacja po wykonaniu";
|
|
170
213
|
verify();
|
|
214
|
+
stage = "SHA po wykonaniu";
|
|
215
|
+
verifyCommit();
|
|
171
216
|
stage = "artefakt";
|
|
172
|
-
const bytes = boundedBytes(within(
|
|
217
|
+
const bytes = boundedBytes(within(copy, input.program.artifact));
|
|
173
218
|
const id = randomUUID(), ref = `artifacts/${id}/${path.basename(input.program.artifact)}`;
|
|
174
219
|
const saved = destination(root, ref);
|
|
175
220
|
writeFileSync(saved, bytes, { flag: "wx", mode: 0o600, flush: true });
|
|
176
221
|
within(root, ref);
|
|
177
222
|
syncDirectory(path.dirname(saved));
|
|
178
|
-
result = eventSchema.parse({ id, at: finishedAt, sha
|
|
223
|
+
result = eventSchema.parse({ id, at: finishedAt, sha, ref,
|
|
179
224
|
operation: input.operation, result: JSON.stringify({ exit: executed.status, stdout: executed.stdout ?? "", stderr: executed.stderr ?? "" }) });
|
|
180
225
|
stage = "walidacja zapisu";
|
|
181
226
|
// Stable key order; validate JSON before serializing so undefined never silently disappears.
|
|
@@ -214,10 +259,8 @@ export function runLocalUsage(input) {
|
|
|
214
259
|
errors.push(new Error(`Użycie — cleanup ${label}: ${String(cause)}`, { cause }));
|
|
215
260
|
}
|
|
216
261
|
};
|
|
217
|
-
if (attempted && worktree)
|
|
218
|
-
cleanup("worktree", () => { git(input.repo, ["worktree", "remove", "--force", owned(root, worktree)]); });
|
|
219
262
|
if (run)
|
|
220
|
-
cleanup("katalog przebiegu", () =>
|
|
263
|
+
cleanup("katalog przebiegu", () => rmSync(owned(root, run), { recursive: true }));
|
|
221
264
|
if (pending)
|
|
222
265
|
cleanup("plik tymczasowy", () => unlinkSync(owned(root, pending)));
|
|
223
266
|
if (lock)
|
package/dist/mcp.d.ts
CHANGED
|
@@ -14,5 +14,5 @@ export interface Connection {
|
|
|
14
14
|
contractVersion: string | null;
|
|
15
15
|
projectCount: number;
|
|
16
16
|
}
|
|
17
|
-
/**
|
|
17
|
+
/** Initialize, discover tools, then prove the key can read the board. */
|
|
18
18
|
export declare function checkConnection(ctx: Ctx, key: string): Promise<Connection>;
|
package/dist/mcp.js
CHANGED
|
@@ -150,6 +150,9 @@ async function rpc(ctx, key, id, method, params) {
|
|
|
150
150
|
throw new RobisieError("Za dużo zapytań z tym kluczem.", `Odczekaj ${res.headers.get("retry-after") ?? "60"} s i uruchom polecenie ponownie.`);
|
|
151
151
|
if (!res.ok)
|
|
152
152
|
throw new RobisieError(`Serwer robisie odpowiedział błędem ${res.status}.`, "Spróbuj ponownie za kilka minut; jeśli błąd zostaje, napisz do robisie.");
|
|
153
|
+
// Notifications have no RPC response; an empty HTTP 202 is successful.
|
|
154
|
+
if (id === undefined)
|
|
155
|
+
return { result: undefined, contractVersion };
|
|
153
156
|
const message = await readRpc(res, id);
|
|
154
157
|
if (!message || message.jsonrpc !== "2.0" || ("result" in message) === ("error" in message))
|
|
155
158
|
throw formatError();
|
|
@@ -160,7 +163,7 @@ async function rpc(ctx, key, id, method, params) {
|
|
|
160
163
|
}
|
|
161
164
|
return { result: message.result, contractVersion };
|
|
162
165
|
}
|
|
163
|
-
/**
|
|
166
|
+
/** Initialize, discover tools, then prove the key can read the board. */
|
|
164
167
|
export async function checkConnection(ctx, key) {
|
|
165
168
|
const init = await rpc(ctx, key, 1, "initialize", {
|
|
166
169
|
protocolVersion: "2025-06-18",
|
|
@@ -171,7 +174,18 @@ export async function checkConnection(ctx, key) {
|
|
|
171
174
|
|| !nonEmptyString(init.result.protocolVersion) || !isRecord(init.result.capabilities))
|
|
172
175
|
throw formatError();
|
|
173
176
|
const serverName = init.result.serverInfo.name;
|
|
174
|
-
const
|
|
177
|
+
const initialized = await rpc(ctx, key, undefined, "notifications/initialized");
|
|
178
|
+
if (initialized.contractVersion !== null)
|
|
179
|
+
assertCompatible(initialized.contractVersion);
|
|
180
|
+
const tools = await rpc(ctx, key, 2, "tools/list", {});
|
|
181
|
+
if (tools.contractVersion !== null)
|
|
182
|
+
assertCompatible(tools.contractVersion);
|
|
183
|
+
if (!isRecord(tools.result) || !Array.isArray(tools.result.tools)
|
|
184
|
+
|| !tools.result.tools.every((tool) => isRecord(tool) && nonEmptyString(tool.name)
|
|
185
|
+
&& isRecord(tool.inputSchema) && tool.inputSchema.type === "object")
|
|
186
|
+
|| !tools.result.tools.some((tool) => tool.name === "list_projects"))
|
|
187
|
+
throw formatError();
|
|
188
|
+
const list = await rpc(ctx, key, 3, "tools/call", { name: "list_projects", arguments: {} });
|
|
175
189
|
const result = list.result;
|
|
176
190
|
if (!isRecord(result) || (result.isError !== undefined && typeof result.isError !== "boolean"))
|
|
177
191
|
throw formatError();
|
|
@@ -198,7 +212,7 @@ export async function checkConnection(ctx, key) {
|
|
|
198
212
|
assertCompatible(list.contractVersion);
|
|
199
213
|
return {
|
|
200
214
|
serverName,
|
|
201
|
-
contractVersion: init.contractVersion ?? list.contractVersion,
|
|
215
|
+
contractVersion: init.contractVersion ?? initialized.contractVersion ?? tools.contractVersion ?? list.contractVersion,
|
|
202
216
|
projectCount: parsed.length,
|
|
203
217
|
};
|
|
204
218
|
}
|
package/dist/roles.d.ts
CHANGED
|
@@ -17,7 +17,7 @@ export interface Role {
|
|
|
17
17
|
export declare function rolesDir(): string;
|
|
18
18
|
export declare function parseRole(file: Role["file"], text: string): Role;
|
|
19
19
|
export declare function loadRoles(dir?: string): Role[];
|
|
20
|
-
export declare const MANAGED_LINE = "<!-- robisie:managed 0.5.
|
|
20
|
+
export declare const MANAGED_LINE = "<!-- robisie:managed 0.5.43 \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/dist/roles.js
CHANGED
|
@@ -77,6 +77,7 @@ export function adapterSection(flavor, codexRolePath) {
|
|
|
77
77
|
"- Use `spawn_builder` to launch the Builder with the launcher shipped in this package; no project-local scripts are required. It selects the Builder provider saved by `npx robisie init` (claude, codex or opencode), keeps the project cwd/environment and confirms the card is `in_progress` with an assignee before reporting success. This does not establish support for mixed-provider review; keep the doctor checks and independent-review requirements.",
|
|
78
78
|
`- If \`spawn_builder\` fails, report its error and resolve the cause before retrying. Only if the operator explicitly chooses manual startup, give this command for a new terminal in the project directory, with the real card id: \`${builderStartCommand(flavor, codexRolePath)}\`. After the operator says it is running, do the one post-launch \`get_task\` read the contract requires.`,
|
|
79
79
|
"- Every role runs in its own session. Never act as two roles in one session.",
|
|
80
|
+
...(flavor === "codex" ? ["- Przed pracą sprawdź dostępność narzędzi serwera `robisie` w tej sesji. Gdy ich brak, zgłoś blokadę z dokładnym komunikatem: „serwer robisie niedostępny w tej sesji — uruchom nową sesję po init”; bez cichego sukcesu, obchodzenia MCP i zmiany statusu karty. Gdy narzędzia są dostępne, kontynuuj zgodnie z kontraktem roli bez restartu sesji. Doctor nie naprawia narzędzi w już otwartej sesji."] : []),
|
|
80
81
|
...(flavor === "opencode" ? ["- OpenCode: brak wspieranego protokołu recenzji. Lokalny plugin `plugins/robisie-review-guard.js` odmawia wywołań `robisie_create_task` i `robisie_update_task` ze statusem `delivered` przed wysłaniem do MCP; taka próba nie zmienia karty. Wynik `task` z accept/VERIFIED, nazwa quality-officer-client, opis Agent ani JSON receiptu nie odblokowują przejścia. Hash receiptu nie dowodzi niezależnej sesji recenzenta."] : []),
|
|
81
82
|
"- The credential comes from the `ROBISIE_KEY` environment variable. Never ask for it in chat and never write it into a card, a file or a command line.",
|
|
82
83
|
"",
|
|
@@ -4,6 +4,12 @@ export type CardLike = {
|
|
|
4
4
|
status?: string | null;
|
|
5
5
|
details?: Record<string, unknown> | null;
|
|
6
6
|
};
|
|
7
|
+
export type TesterEnvironment = {
|
|
8
|
+
kind: "local-docker";
|
|
9
|
+
episode: string;
|
|
10
|
+
owner: "control-room" | "installation-manager";
|
|
11
|
+
};
|
|
12
|
+
export declare function testerEnvironment(value: unknown): value is TesterEnvironment;
|
|
7
13
|
export type TesterExecution = {
|
|
8
14
|
sha: string;
|
|
9
15
|
at: string;
|
|
@@ -20,6 +26,7 @@ export type TesterExecution = {
|
|
|
20
26
|
timeoutPaths: string[];
|
|
21
27
|
skippedTests: string[];
|
|
22
28
|
transcript: string;
|
|
29
|
+
environment?: TesterEnvironment;
|
|
23
30
|
retest?: TesterRetestGrant | null;
|
|
24
31
|
baselineFailures?: {
|
|
25
32
|
command: string;
|
|
@@ -1,6 +1,11 @@
|
|
|
1
1
|
import { readFileSync, existsSync } from "node:fs";
|
|
2
2
|
import { isDeepStrictEqual } from "node:util";
|
|
3
3
|
import path from "node:path";
|
|
4
|
+
export function testerEnvironment(value) {
|
|
5
|
+
const e = value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
|
|
6
|
+
return e.kind === "local-docker" && typeof e.episode === "string" && /^[a-f0-9]{64}$/.test(e.episode)
|
|
7
|
+
&& ["control-room", "installation-manager"].includes(String(e.owner));
|
|
8
|
+
}
|
|
4
9
|
export function validTestSha(value) {
|
|
5
10
|
return typeof value === "string" && /^[a-f0-9]{7,40}$/i.test(value);
|
|
6
11
|
}
|
|
@@ -82,6 +87,8 @@ export function execution(value, input) {
|
|
|
82
87
|
|| !(r.base === null || validTestSha(r.base)) || !(r.testedHead === "UNKNOWN" || validTestSha(r.testedHead))
|
|
83
88
|
|| !(r.failed === null || (typeof failed.command === "string" && typeof failed.output === "string")))
|
|
84
89
|
throw new Error("Niepoprawny wynik joba testera");
|
|
90
|
+
if (r.environment != null && r.environment !== "" && (!testerEnvironment(r.environment) || !r.failed || failed.command !== "PREPARATION_ERROR"))
|
|
91
|
+
throw new Error("Niepoprawny dowód środowiska testera");
|
|
85
92
|
if (r.retest !== undefined)
|
|
86
93
|
retestGrant(r.retest, { ...input.card, details: { ...input.card.details, test: { at: r.at } } });
|
|
87
94
|
return value;
|
package/docs/README.en.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# robisie — from account to accepted card (package 0.5.
|
|
1
|
+
# robisie — from account to accepted card (package 0.5.43) <!-- 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
|
|
|
@@ -365,7 +365,7 @@ Start the CEO in this directory: `claude --agent ceo-client`, or `codex` with th
|
|
|
365
365
|
|
|
366
366
|
> CEO, create a local card to change greet.cjs using the goal and literal details object below. Use the real project from list_projects and its board track. Change only greet.cjs, without dependencies, accounts or publication. Use my existing authorization if it covers this goal, directory, scope and acceptance; otherwise ask before dependent work. Supply actual authoring providers and a future deadline, then prepare the card as ready. After execution I need an independent tester and ACK, three uses for Ala/Bartek/Celina, and separate final acceptance.
|
|
367
367
|
|
|
368
|
-
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`. The only list of all promised criteria is `done_when`; Builder evidence goes to `verification` and `summary` without overwriting criteria. 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
|
|
368
|
+
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`. The only list of all promised criteria is `done_when`; Builder evidence goes to `verification` and `summary` without overwriting criteria. 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 copy of the landed SHA in a run directory under `stateDir`.
|
|
369
369
|
|
|
370
370
|
<!-- local-card-details:start -->
|
|
371
371
|
```json
|
|
@@ -412,7 +412,7 @@ Save the complete input below as `usage.json` in the current directory. Take `re
|
|
|
412
412
|
npx robisie usage --input ./usage.json
|
|
413
413
|
```
|
|
414
414
|
|
|
415
|
-
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
|
|
415
|
+
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`.
|
|
416
416
|
|
|
417
417
|
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.
|
|
418
418
|
|
package/docs/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# robisie — od konta do odebranej karty (paczka 0.5.
|
|
1
|
+
# robisie — od konta do odebranej karty (paczka 0.5.43) <!-- 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
|
|
|
@@ -412,7 +412,7 @@ Uruchom CEO w tym katalogu: `claude --agent ceo-client`, albo `codex` z rolą ro
|
|
|
412
412
|
|
|
413
413
|
> CEO, utwórz lokalną kartę zmiany greet.cjs według celu i literalnego obiektu details poniżej. Użyj rzeczywistego projektu z list_projects i toru z tablicy. Zmień wyłącznie greet.cjs, bez zależności, kont i publikacji. Korzystaj z wcześniejszej zgody, jeśli obejmuje ten cel, katalog, zakres i odbiór; inaczej zapytaj przed zależnym krokiem. Wstaw prawdziwych dostawców autorstwa i przyszły deadline, przygotuj kartę do ready. Po pracy potrzebuję niezależnego testera i ACK, trzech użyć Ala/Bartek/Celina oraz osobnego końcowego odbioru.
|
|
414
414
|
|
|
415
|
-
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`. Jedyną listą wszystkich obiecanych kryteriów jest `done_when`; dowody wykonania trafiają do `verification` i `summary`, bez nadpisywania kryteriów. 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
|
|
415
|
+
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`. Jedyną listą wszystkich obiecanych kryteriów jest `done_when`; dowody wykonania trafiają do `verification` i `summary`, bez nadpisywania kryteriów. 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 kopii landed SHA w katalogu przebiegu pod `stateDir`.
|
|
416
416
|
|
|
417
417
|
<!-- local-card-details:start -->
|
|
418
418
|
```json
|
|
@@ -459,7 +459,7 @@ Zapisz poniższy pełny input jako `usage.json` w bieżącym katalogu. `repo` we
|
|
|
459
459
|
npx robisie usage --input ./usage.json
|
|
460
460
|
```
|
|
461
461
|
|
|
462
|
-
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
|
|
462
|
+
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`.
|
|
463
463
|
|
|
464
464
|
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.
|
|
465
465
|
|
package/package.json
CHANGED