Diffinery

codician/diffinerypublic

Open-source, agent-first GitHub and GitHub Actions alternative that runs on your own Cloudflare account: git hosting, pull requests, code review and drop-in GitHub Actions YAML on Workers, Durable Objects, R2 and Containers.

3262 lines · 199.2 KBRaw History
1// End-to-end: a real `wrangler dev` Worker, the real git CLI and the real runner agent.
2//
3// pnpm --filter @diffinery/runner build && pnpm --filter @diffinery/app e2e
4//
5// Covers: token auth, repo creation, git push/clone/fetch (protocol v2), push
6// protection, workflows triggered by push and pull_request and executed by a
7// self-hosted runner (the same agent that runs in Cloudflare Containers),
8// check runs, branch protection with required checks and human review for
9// agent-authored PRs, merging, the REST contents API, the MCP server and
10// profile pictures (WASM image processing in the Worker).
11import "./fresh-connections.mjs";
12import { spawn, spawnSync, execFileSync } from "node:child_process";
13import { mkdtempSync, writeFileSync, mkdirSync, readFileSync, existsSync, rmSync, openSync } from "node:fs";
14import { tmpdir } from "node:os";
15import { createHash, randomBytes } from "node:crypto";
16import { join, dirname, resolve } from "node:path";
17import { fileURLToPath } from "node:url";
18import { crc32, deflateSync } from "node:zlib";
19import { test, describe, before, after } from "node:test";
20import assert from "node:assert/strict";
21import { fakeGitHub, lfsObject } from "./fake-github.mjs";
22import { migratedState } from "./d1-state.mjs";
23import { freePort } from "./ports.mjs";
24
25const APP = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
26const AGENT = resolve(APP, "../../containers/runner/dist/agent.mjs");
27const work = mkdtempSync(join(tmpdir(), "diffinery-e2e-"));
28let base;
29/** The shared server's Worker itself, behind wrangler dev's proxy (see startServer). */
30let direct;
31// The dev server writes to a file, not a pipe: a long synchronous git command keeps this process
32// from reading a pipe, and a full one (retried webhooks log a stack each) stalls the server mid-push.
33const devLogFile = join(work, "wrangler.log");
34const devLog = () => (existsSync(devLogFile) ? readFileSync(devLogFile, "utf8") : "");
35let token;
36let agentToken;
37
38async function api(method, path, body, tok = token) {
39 const send = () =>
40 fetch(`${base}/api/v3${path}`, {
41 method,
42 headers: { ...(tok === null ? {} : { authorization: `Bearer ${tok}` }), "content-type": "application/json" },
43 body: body === undefined ? undefined : JSON.stringify(body),
44 });
45 // After minutes of git traffic alone, the kept-alive connection from the last API call may have
46 // been closed by the dev server just as it is reused ("other side closed"): a GET is sent again.
47 let res;
48 for (let i = 0; ; i++) {
49 try {
50 res = await send();
51 break;
52 } catch (e) {
53 if (method !== "GET" || i >= 2) throw new Error(`${method} ${path}: ${e.message} (${e.cause?.code ?? e.cause})\n--- wrangler log tail ---\n${devLog().slice(-3000)}`);
54 await sleep(1000);
55 }
56 }
57 const text = await res.text();
58 let json = null;
59 try {
60 json = text ? JSON.parse(text) : null;
61 } catch {
62 json = text;
63 }
64 return { status: res.status, json };
65}
66
67/**
68 * Claim a waiting self-hosted job as a registered runner offering `labels`, the way `diffinery runner`
69 * does (personal tokens can't claim jobs): one runner per repository and set of labels.
70 */
71const e2eRunners = new Map();
72async function runnerClaim(repoPath, labels = ["linux"]) {
73 const key = `${repoPath} ${labels.join(",")}`;
74 if (!e2eRunners.has(key)) {
75 const reg = await api("POST", `${repoPath}/actions/runners/registration-token`);
76 assert.equal(reg.status, 201, JSON.stringify(reg.json));
77 const runner = await api("POST", `${repoPath}/actions/runners/register`, { registration_token: reg.json.token, name: `e2e-runner-${e2eRunners.size + 1}`, labels });
78 assert.equal(runner.status, 201, JSON.stringify(runner.json));
79 e2eRunners.set(key, runner.json.token);
80 }
81 const r = await api("POST", `${repoPath}/actions/runners/claim`, {}, e2eRunners.get(key));
82 // A repository deleted and created again under the same name needs a new runner.
83 if (r.status !== 401) return r;
84 e2eRunners.delete(key);
85 return runnerClaim(repoPath, labels);
86}
87async function ok(method, path, body, tok) {
88 const r = await api(method, path, body, tok);
89 assert.ok(r.status >= 200 && r.status < 300, `${method} ${path} -> ${r.status} ${JSON.stringify(r.json)}`);
90 return r.json;
91}
92
93function git(cwd, args, tok = token, opts = {}) {
94 const auth = Buffer.from(`x-token:${tok}`).toString("base64");
95 try {
96 return execFileSync("git", ["-c", `http.extraHeader=Authorization: Basic ${auth}`, "-c", "protocol.version=2", ...args], {
97 cwd,
98 encoding: "utf8",
99 stdio: ["ignore", "pipe", "pipe"],
100 env: { ...process.env, GIT_TERMINAL_PROMPT: "0", GIT_AUTHOR_NAME: "E2E", GIT_AUTHOR_EMAIL: "e2e@example.com", GIT_COMMITTER_NAME: "E2E", GIT_COMMITTER_EMAIL: "e2e@example.com" },
101 ...opts,
102 });
103 } catch (e) {
104 // What the server said, for a git command that wasn't meant to fail (gitFails reads stderr, not this).
105 if (/HTTP 5\d\d/.test(e.stderr ?? "")) e.message += `\n--- wrangler log tail ---\n${devLog().slice(-4000)}`;
106 throw e;
107 }
108}
109function gitFails(cwd, args, tok) {
110 try {
111 git(cwd, args, tok);
112 } catch (e) {
113 return `${e.stdout ?? ""}${e.stderr ?? ""}`;
114 }
115 assert.fail(`expected git ${args.join(" ")} to fail`);
116}
117
118const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
119async function until(what, fn, timeoutMs = 60_000) {
120 const end = Date.now() + timeoutMs;
121 let last;
122 while (Date.now() < end) {
123 last = await fn();
124 if (last) return last;
125 await sleep(500);
126 }
127 assert.fail(`timed out waiting for ${what}\n--- wrangler log tail ---\n${devLog().slice(-4000)}`);
128}
129
130function spawnAsync(cmd, args, env, timeoutMs) {
131 return new Promise((done) => {
132 const child = spawn(cmd, args, { env: { ...process.env, ...env } });
133 let stdout = "";
134 let stderr = "";
135 child.stdout.on("data", (d) => (stdout += d));
136 child.stderr.on("data", (d) => (stderr += d));
137 const t = setTimeout(() => child.kill("SIGKILL"), timeoutMs);
138 child.on("close", (status) => {
139 clearTimeout(t);
140 done({ status, stdout, stderr });
141 });
142 });
143}
144
145/**
146 * Claim one waiting self-hosted job and run it with the real agent.
147 * `envFor(claim)` adds environment for the agent (e.g. HOME, DIFFINERY_DISABLE_BUILTINS).
148 */
149async function runOneJob(owner, repo, { allowFailure = false, envFor = () => ({}), timeoutMs = 180_000, labels = ["linux"] } = {}) {
150 const claim = await until("a job to claim", async () => {
151 const r = await runnerClaim(`/repos/${owner}/${repo}`, labels);
152 return r.status === 200 ? r.json : null;
153 });
154 const jobEnv = { ...envFor(claim), DIFFINERY_API_URL: claim.api_url, DIFFINERY_JOB_ID: claim.job_id, DIFFINERY_JOB_TOKEN: claim.token };
155 // E2E_RUNNER_IMAGE runs the job inside the real runner image instead of the local agent bundle.
156 const image = process.env.E2E_RUNNER_IMAGE;
157 // Spawned asynchronously: a blocked event loop leaves undici holding keep-alive sockets the server already closed.
158 const r = image
159 ? await spawnAsync("docker", ["run", "--rm", "--network", "host", ...Object.entries(jobEnv).flatMap(([k, v]) => ["-e", `${k}=${v}`]), image], {}, timeoutMs + 120_000)
160 : await spawnAsync(process.execPath, [AGENT], { ...process.env, ...jobEnv, DIFFINERY_WORK_ROOT: join(work, `job-${claim.job_id}`) }, timeoutMs);
161 const out = `${r.stdout}${r.stderr}`;
162 if (r.status !== 0 && !allowFailure) {
163 const log = await fetch(`${base}/api/v3/repos/${owner}/${repo}/actions/jobs/${claim.job_id}/logs`, { headers: { authorization: `Bearer ${token}` } }).then((x) => x.text(), (e) => String(e));
164 const job = await api("GET", `/repos/${owner}/${repo}/actions/jobs/${claim.job_id}`).catch((e) => ({ json: String(e) }));
165 assert.fail(`runner agent exited ${r.status}:\n${out}\n--- job ---\n${JSON.stringify(job.json, null, 2)}\n--- job log ---\n${log}\n--- wrangler log tail ---\n${devLog().slice(-3000)}`);
166 }
167 return { claim, out };
168}
169
170/**
171 * A `wrangler dev` server of its own with an admin token. Most tests share the one before() starts;
172 * the real histories each push to their own, so they run side by side on separate processes.
173 */
174const servers = [];
175/** `restart`: start again on the state a stopped server of the same name left. */
176async function startServer(name = "", { restart = false } = {}) {
177 const port = await freePort();
178 const url = `http://127.0.0.1:${port}`;
179 const persist = join(work, name ? `state-${name}` : "state");
180 const logFile = name ? join(work, `wrangler-${name}.log`) : devLogFile;
181 const debugLogFile = join(work, name ? `wrangler-debug-${name}.log` : "wrangler-debug.log");
182 const log = () => (existsSync(logFile) ? readFileSync(logFile, "utf8") : "");
183 if (!restart) migratedState(APP, persist);
184 // Until the web UI exists, run the same app through the API-only entry.
185 const entry = existsSync(join(APP, "src/web/routes.tsx")) ? [] : ["test/e2e/entry.ts"];
186 const out = openSync(logFile, "a");
187 const child = spawn("pnpm", ["exec", "wrangler", "dev", ...entry, "-e", "dev", "--ip", "127.0.0.1", "--port", String(port), "--inspector-port", String(await freePort()), "--persist-to", persist, "--var", `PUBLIC_URL:${url}`, "--var", `MASTER_KEY:${randomBytes(32).toString("base64")}`, "--var", "SCHEDULE_TICK_MINUTES:1", "--show-interactive-dev-session=false"], {
188 cwd: APP,
189 env: { ...process.env, CI: "1", WRANGLER_SEND_METRICS: "false", WRANGLER_LOG_PATH: debugLogFile },
190 stdio: ["ignore", out, out],
191 detached: true,
192 });
193 servers.push(child);
194 const end = Date.now() + 120_000;
195 while (!(await fetch(`${url}/healthz`).then((r) => r.ok, () => false))) {
196 if (Date.now() > end) assert.fail(`timed out waiting for wrangler dev${name ? ` (${name})` : ""}\n--- wrangler log tail ---\n${log().slice(-4000)}`);
197 await sleep(500);
198 }
199 // DEV_AUTH signs requests without credentials in as dev@diffinery.local; mint a real token for everything else.
200 const res = await fetch(`${url}/api/v3/diffinery/tokens`, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ name: "e2e", scopes: ["admin"] }) });
201 assert.equal(res.status, 201, await res.clone().text());
202 const stop = () => {
203 try {
204 process.kill(-child.pid, "SIGTERM");
205 } catch {}
206 };
207 return { base: url, direct: workerUrl(debugLogFile), workerUrl: () => workerUrl(debugLogFile), token: (await res.json()).token, log, stop };
208}
209
210/**
211 * wrangler dev answers on `base` through a proxy Worker of its own, which drops one of several large
212 * pushes streaming through it at once ("Error inside ProxyWorker ... Network connection lost": the
213 * push never reaches our Worker; 3 of 5 runs of three pushes, none of 5 sent to the Worker itself).
214 * Its debug log names the Worker's own address; null if it doesn't.
215 */
216function workerUrl(debugLogFile) {
217 const log = existsSync(debugLogFile) ? readFileSync(debugLogFile, "utf8") : "";
218 const at = [...log.matchAll(/"userWorkerUrl":\{"protocol":"(https?:)","hostname":"([^"]+)","port":"(\d+)"/g)].pop();
219 return at ? `${at[1]}//${at[2]}:${at[3]}` : null;
220}
221
222before(async () => {
223 assert.ok(existsSync(AGENT), `build the runner first: pnpm --filter @diffinery/runner build (missing ${AGENT})`);
224 ({ base, direct, token } = await startServer());
225});
226
227after(() => {
228 for (const dev of servers) {
229 try {
230 process.kill(-dev.pid, "SIGTERM");
231 } catch {}
232 }
233 if (process.env.E2E_KEEP !== "1") rmSync(work, { recursive: true, force: true });
234});
235
236// Scheduled workflows: the dev environment has no cron trigger, like a deploy whose cron trigger
237// hasn't been applied yet, so schedules must fire from the scheduler's own alarm. The schedule is
238// registered first and checked by the last test, so its ticks (1 minute here) come while the rest runs.
239let tickRepo;
240test("scheduled workflows: a push to the default branch registers the schedule", async () => {
241 const me = await ok("GET", "/user");
242 tickRepo = `${me.login}/schedules`;
243 await ok("POST", "/user/repos", { name: "schedules" });
244 const src = join(work, "schedules");
245 mkdirSync(join(src, ".github/workflows"), { recursive: true });
246 writeFileSync(join(src, ".github/workflows/tick.yml"), `on:\n schedule:\n - cron: "* * * * *"\njobs:\n tick:\n runs-on: [self-hosted, linux]\n steps:\n - run: echo tick\n`);
247 git(src, ["init", "-q", "-b", "main"]);
248 git(src, ["add", "-A"]);
249 git(src, ["commit", "-q", "-m", "schedule"]);
250 git(src, ["push", "-q", `${base}/${tickRepo}.git`, "main"]);
251});
252
253test("git hosting, Actions, protected PR flow and MCP", async () => {
254 const me = await ok("GET", "/user");
255 const owner = me.login;
256 assert.ok(me.site_admin, "dev user is a bootstrap admin");
257
258 // ------------------------------------------------------------ repo + first push
259 const repo = await ok("POST", "/user/repos", { name: "demo", description: "e2e" });
260 assert.equal(repo.full_name, `${owner}/demo`);
261 const src = join(work, "src");
262 mkdirSync(join(src, ".github/workflows"), { recursive: true });
263 writeFileSync(join(src, "README.md"), "# demo\n");
264 writeFileSync(join(src, "app.txt"), "one\ntwo\nthree\n");
265 writeFileSync(
266 join(src, ".github/workflows/ci.yml"),
267 `name: CI
268on:
269 push:
270 branches: [main]
271 pull_request:
272jobs:
273 build:
274 runs-on: [self-hosted, linux]
275 steps:
276 - uses: actions/checkout@v4
277 - name: Check files
278 run: |
279 test -f README.md
280 echo "event=\${{ github.event_name }} sha=\${{ github.sha }}"
281 grep -q bad app.txt && { echo "found bad line"; exit 1; } || true
282 - id: out
283 run: echo "lines=$(wc -l < app.txt | tr -d ' ')" >> "$GITHUB_OUTPUT"
284 - run: echo "app.txt has \${{ steps.out.outputs.lines }} lines"
285`,
286 );
287 git(src, ["init", "-q", "-b", "main"]);
288 git(src, ["add", "-A"]);
289 git(src, ["commit", "-q", "-m", "initial"]);
290 git(src, ["remote", "add", "origin", `${base}/${owner}/demo.git`]);
291 git(src, ["push", "-q", "origin", "main"]);
292 const mainSha = git(src, ["rev-parse", "HEAD"]).trim();
293
294 const branch = await ok("GET", `/repos/${owner}/demo/branches/main`);
295 assert.equal(branch.commit.sha, mainSha);
296
297 // ------------------------------------------------------------ the push ran CI on a self-hosted runner
298 const pushRun = await until("push run", async () => (await ok("GET", `/repos/${owner}/demo/actions/runs?event=push`)).workflow_runs[0]);
299 assert.equal(pushRun.head_sha, mainSha);
300 const job1 = await runOneJob(owner, "demo");
301 const finished = await until("push run to complete", async () => {
302 const r = await ok("GET", `/repos/${owner}/demo/actions/runs/${pushRun.id}`);
303 return r.status === "completed" ? r : null;
304 });
305 assert.equal(finished.conclusion, "success", job1.out);
306 const logs = await (await fetch(`${base}/api/v3/repos/${owner}/demo/actions/jobs/${job1.claim.job_id}/logs`, { headers: { authorization: `Bearer ${token}` } })).text();
307 assert.match(logs, /event=push/);
308 assert.match(logs, /app\.txt has 3 lines/);
309 const checks = await ok("GET", `/repos/${owner}/demo/commits/${mainSha}/check-runs`);
310 assert.equal(checks.check_runs.find((c) => c.name === "CI / build")?.conclusion, "success");
311
312 // ------------------------------------------------------------ clone over protocol v2
313 const clone = join(work, "clone");
314 git(work, ["clone", "-q", `${base}/${owner}/demo.git`, clone]);
315 assert.equal(readFileSync(join(clone, "app.txt"), "utf8"), "one\ntwo\nthree\n");
316
317 // ------------------------------------------------------------ secrets are blocked on push
318 // The key below is a fake that push protection must block in the pushed file; this
319 // marker exempts only the test source itself: diffinery:allow-secret
320 writeFileSync(join(clone, "config.env"), "AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPL3\n");
321 git(clone, ["add", "-A"]);
322 git(clone, ["commit", "-q", "-m", "oops"]);
323 assert.match(gitFails(clone, ["push", "origin", "main"]), /secret|AWS/i);
324 // Objects from a blocked push are not kept, so retrying (even with push negotiation) is blocked too.
325 assert.match(gitFails(clone, ["-c", "push.negotiate=true", "push", "origin", "HEAD:refs/heads/fixture"]), /secret|AWS/i);
326 // A repository admin can push anyway by giving a reason; the bypass is audited.
327 assert.match(gitFails(clone, ["push", "-o", "allow-secrets=", "origin", "HEAD:refs/heads/fixture"]), /secret|AWS/i);
328 git(clone, ["push", "-q", "-o", "allow-secrets=fake key used by this test", "origin", "HEAD:refs/heads/fixture"]);
329 assert.ok((await ok("GET", `/repos/${owner}/demo/branches`)).some((b) => b.name === "fixture"));
330 git(clone, ["push", "-q", "origin", ":refs/heads/fixture"]);
331 git(clone, ["reset", "-q", "--hard", "origin/main"]);
332
333 // ------------------------------------------------------------ protect main: PR + green CI + review
334 await ok("PUT", `/repos/${owner}/demo/branches/main/protection`, {
335 requirePullRequest: true,
336 requiredApprovals: 0,
337 dismissStaleReviews: true,
338 requiredChecks: ["CI / build"],
339 allowForcePush: false,
340 allowDeletion: false,
341 requireLinearHistory: false,
342 enforceAdmins: true,
343 agentsMayPush: false,
344 agentsMayMerge: false,
345 });
346 writeFileSync(join(clone, "app.txt"), "one\ntwo\nthree\nfour\n");
347 git(clone, ["commit", "-q", "-am", "direct push"]);
348 assert.match(gitFails(clone, ["push", "origin", "main"]), /pull request|protected/i);
349 git(clone, ["reset", "-q", "--hard", "origin/main"]);
350
351 // ------------------------------------------------------------ an AI agent opens a PR
352 const created = await ok("POST", "/diffinery/agents", { login: "e2e-bot", name: "E2E Bot" }, null);
353 agentToken = created.token.token;
354 const agentClone = join(work, "agent");
355 git(work, ["clone", "-q", `${base}/${owner}/demo.git`, agentClone], agentToken);
356 git(agentClone, ["checkout", "-q", "-b", "feature"], agentToken);
357 writeFileSync(join(agentClone, "app.txt"), "one\ntwo\nthree\nfour\n");
358 git(agentClone, ["commit", "-q", "-am", "Add a fourth line"], agentToken);
359 assert.match(gitFails(agentClone, ["push", "origin", "HEAD:main"], agentToken), /agent|protected|pull request/i);
360 // push.negotiate=true makes git run a protocol v2 fetch with wait-for-done before pushing.
361 const negotiated = spawnSync("git", ["-c", `http.extraHeader=Authorization: Basic ${Buffer.from(`x-token:${agentToken}`).toString("base64")}`, "-c", "protocol.version=2", "-c", "push.negotiate=true", "push", "-q", "origin", "feature"], { cwd: agentClone, encoding: "utf8", env: { ...process.env, GIT_TERMINAL_PROMPT: "0" } });
362 assert.equal(negotiated.status, 0, negotiated.stderr);
363 assert.doesNotMatch(negotiated.stderr, /negotiation failed|unexpected/i);
364 const pr = await ok("POST", `/repos/${owner}/demo/pulls`, { title: "Add a fourth line", head: "feature", base: "main", intent: "Extend app.txt for the e2e test" }, agentToken);
365 assert.equal(pr.number, 1);
366
367 // An agent may start an empty repository's default branch (as auto_init would), and then only through pull requests.
368 await ok("POST", "/user/repos", { name: "agent-seeded", private: true });
369 const seed = join(work, "agent-seeded");
370 git(work, ["init", "-q", "-b", "main", seed]);
371 mkdirSync(join(seed, ".github/workflows"), { recursive: true });
372 writeFileSync(join(seed, ".github/workflows/ci.yml"), "on: push\njobs:\n a:\n runs-on: ubuntu-latest\n steps:\n - run: true\n");
373 writeFileSync(join(seed, "README.md"), "# seeded by an agent\n");
374 git(seed, ["add", "-A"]);
375 git(seed, ["commit", "-q", "-m", "Initial commit"]);
376 // Not with workflow files: those reach the default branch only through a pull request a person merges.
377 assert.match(gitFails(seed, ["push", `${base}/${owner}/agent-seeded.git`, "main"], agentToken), /can't add workflow file `\.github\/workflows\/ci\.yml`/);
378 git(seed, ["rm", "-q", "-r", ".github"]);
379 git(seed, ["commit", "-q", "--amend", "-m", "Initial commit"]);
380 git(seed, ["push", "-q", `${base}/${owner}/agent-seeded.git`, "main"], agentToken);
381 writeFileSync(join(seed, "README.md"), "# changed\n");
382 git(seed, ["commit", "-q", "-am", "Second commit"]);
383 assert.match(gitFails(seed, ["push", `${base}/${owner}/agent-seeded.git`, "main"], agentToken), /agents may not push to protected or default branches/);
384
385 // The pull_request run executes; until then the PR is blocked on the required check.
386 let m = await ok("GET", `/repos/${owner}/demo/pulls/1/merge`);
387 assert.equal(m.mergeable, false);
388 await runOneJob(owner, "demo");
389 await until("PR check to pass", async () => {
390 const r = await ok("GET", `/repos/${owner}/demo/pulls/1/merge`);
391 return r.checks?.length > 0 && r.checks.every((c) => c.state === "success") ? r : null;
392 });
393 m = await ok("GET", `/repos/${owner}/demo/pulls/1/merge`);
394 assert.equal(m.mergeable, false, "agent-authored PRs need a human approval");
395 assert.ok(JSON.stringify(m.blockers).match(/approv|human/i), JSON.stringify(m.blockers));
396
397 // The agent cannot approve or merge its own work.
398 const agentMerge = await api("PUT", `/repos/${owner}/demo/pulls/1/merge`, { merge_method: "squash" }, agentToken);
399 assert.ok([403, 405, 409].includes(agentMerge.status), JSON.stringify(agentMerge));
400
401 // Another agent's approval is advisory and does not unblock the merge.
402 const reviewer = (await ok("POST", "/diffinery/agents", { login: "e2e-reviewer" }, null)).token.token;
403 await ok("POST", `/repos/${owner}/demo/pulls/1/reviews`, { event: "APPROVE", body: "bot says ok" }, reviewer);
404 assert.equal((await ok("GET", `/repos/${owner}/demo/pulls/1/merge`)).mergeable, false);
405
406 // A human reviews (line comment + approval) and merges.
407 await ok("POST", `/repos/${owner}/demo/pulls/1/reviews`, { event: "APPROVE", body: "LGTM", comments: [{ path: "app.txt", line: 4, body: "nice line" }] });
408 m = await ok("GET", `/repos/${owner}/demo/pulls/1/merge`);
409 assert.equal(m.mergeable, true, JSON.stringify(m));
410 const merged = await ok("PUT", `/repos/${owner}/demo/pulls/1/merge`, { merge_method: "squash", delete_branch: true });
411 assert.ok(merged.sha);
412 const prAfter = await ok("GET", `/repos/${owner}/demo/pulls/1`);
413 assert.equal(prAfter.merged, true);
414
415 // ------------------------------------------------------------ fetch the merge, read through REST
416 git(clone, ["pull", "-q", "--ff-only", "origin", "main"]);
417 assert.equal(readFileSync(join(clone, "app.txt"), "utf8"), "one\ntwo\nthree\nfour\n");
418 const content = await ok("GET", `/repos/${owner}/demo/contents/app.txt`);
419 assert.equal(Buffer.from(content.content, "base64").toString(), "one\ntwo\nthree\nfour\n");
420 const branches = await ok("GET", `/repos/${owner}/demo/branches`);
421 assert.ok(!branches.some((b) => b.name === "feature"), "head branch deleted after merge");
422
423 // ------------------------------------------------------------ shallow clone, then deepen
424 const shallow = join(work, "shallow");
425 git(work, ["clone", "-q", "--depth", "1", `${base}/${owner}/demo.git`, shallow]);
426 assert.equal(git(shallow, ["rev-list", "--count", "HEAD"]).trim(), "1");
427 assert.equal(readFileSync(join(shallow, "app.txt"), "utf8"), "one\ntwo\nthree\nfour\n");
428 git(shallow, ["fetch", "-q", "--unshallow"]);
429 assert.equal(git(shallow, ["rev-list", "--count", "HEAD"]).trim(), "2");
430 git(shallow, ["fsck", "--no-progress"]);
431
432 // ------------------------------------------------------------ MCP: the agent works without git
433 const rpc = async (method, params, id = 1) => {
434 const r = await fetch(`${base}/mcp`, { method: "POST", headers: { authorization: `Bearer ${agentToken}`, "content-type": "application/json", accept: "application/json, text/event-stream" }, body: JSON.stringify({ jsonrpc: "2.0", id, method, params }) });
435 assert.equal(r.status, 200);
436 return (await r.json()).result;
437 };
438 const init = await rpc("initialize", { protocolVersion: "2025-06-18", capabilities: {}, clientInfo: { name: "e2e", version: "1" } });
439 assert.equal(init.serverInfo.name, "diffinery");
440 const tools = await rpc("tools/list", {});
441 assert.ok(tools.tools.some((t) => t.name === "commit_files"));
442 const file = await rpc("tools/call", { name: "get_file", arguments: { owner, repo: "demo", path: "README.md" } });
443 assert.equal(file.isError, false);
444 assert.equal(file.structuredContent.content, "# demo\n");
445 const commit = await rpc("tools/call", { name: "commit_files", arguments: { owner, repo: "demo", branch: "mcp-change", create_branch_from: "main", message: "Edit via MCP", files: [{ path: "docs/notes.md", content: "hello\n" }] } });
446 assert.equal(commit.isError, false, JSON.stringify(commit));
447 assert.equal(commit.structuredContent.html_url, `${base}/${owner}/demo/commit/${commit.structuredContent.sha}`);
448 const blocked = await rpc("tools/call", { name: "commit_files", arguments: { owner, repo: "demo", branch: "main", message: "sneaky", files: [{ path: "x", content: "y" }] } });
449 assert.equal(blocked.isError, true);
450 const opened = await rpc("tools/call", { name: "create_pull_request", arguments: { owner, repo: "demo", title: "Notes", head: "mcp-change", intent: "Add notes" } });
451 assert.equal(opened.isError, false, JSON.stringify(opened));
452 assert.equal(opened.structuredContent.number, 2);
453 // Results link to what they made or read, for the agent to hand people.
454 assert.equal(opened.structuredContent.html_url, `${base}/${owner}/demo/pull/2`);
455 const said = await rpc("tools/call", { name: "comment", arguments: { owner, repo: "demo", number: 2, body: "Ready for a look" } });
456 assert.equal(said.structuredContent.html_url, `${base}/${owner}/demo/issues/2#c-${said.structuredContent.id}`);
457 const runs = await rpc("tools/call", { name: "list_workflow_runs", arguments: { owner, repo: "demo" } });
458 const run = runs.structuredContent.runs[0];
459 assert.equal(run.html_url, `${base}/${owner}/demo/actions/runs/${run.id}`);
460 const detail = await rpc("tools/call", { name: "get_workflow_run", arguments: { owner, repo: "demo", run_id: run.id } });
461 assert.equal(detail.structuredContent.jobs[0].html_url, `${base}/${owner}/demo/actions/runs/${run.id}/job/${detail.structuredContent.jobs[0].id}`);
462 for (const path of [new URL(said.structuredContent.html_url).pathname, new URL(detail.structuredContent.jobs[0].html_url).pathname]) assert.equal((await fetch(`${base}${path}`)).status, 200, path);
463
464 // ------------------------------------------------------------ web UI renders the same data (signed in via DEV_AUTH)
465 for (const path of ["/", `/${owner}`, `/${owner}/demo`, `/${owner}/demo/blob/main/app.txt`, `/${owner}/demo/commits/main`, `/${owner}/demo/pulls`, `/${owner}/demo/pull/1`, `/${owner}/demo/pull/1/files`, `/${owner}/demo/actions`, `/${owner}/demo/actions/runs/${pushRun.id}`, `/${owner}/demo/actions/runs/${pushRun.id}/job/${job1.claim.job_id}`, `/${owner}/demo/settings/branches`, "/settings/tokens"]) {
466 const res = await fetch(`${base}${path}`);
467 const html = await res.text();
468 assert.equal(res.status, 200, `${path} -> ${res.status}\n${html.slice(0, 500)}`);
469 assert.match(res.headers.get("content-type") ?? "", /text\/html/, path);
470 }
471 assert.match(await (await fetch(`${base}/${owner}/demo/pull/1`)).text(), /Add a fourth line/);
472 const forged = await fetch(`${base}/${owner}/demo/issues/1/comment`, { method: "POST", headers: { "content-type": "application/x-www-form-urlencoded", origin: "https://evil.example", "sec-fetch-site": "cross-site" }, body: "body=hi" });
473 assert.equal(forged.status, 403);
474
475 // ------------------------------------------------------------ the CLI against the same server
476 const CLI = resolve(APP, "../cli/dist/diffinery.mjs");
477 if (existsSync(CLI)) {
478 const cli = (...args) => execFileSync(process.execPath, [CLI, ...args], { encoding: "utf8", cwd: clone, env: { ...process.env, DIFFINERY_URL: base, DIFFINERY_TOKEN: token, NO_COLOR: "1", XDG_CONFIG_HOME: join(work, "cfg") } });
479 assert.match(cli("whoami"), new RegExp(owner));
480 const prs = JSON.parse(cli("pr", "list", "--state", "all", "--json"));
481 assert.ok(prs.some((p) => p.number === 1));
482 assert.match(cli("workflow", "validate"), /ci\.yml/);
483 }
484
485 // The commit made through MCP carries the agent's identity.
486 const agentCommit = await ok("GET", `/repos/${owner}/demo/commits/mcp-change`);
487 assert.match(JSON.stringify(agentCommit), /e2e-bot/);
488});
489
490// 2026-10-24: objects of 64 KB to 1 MB failed to inflate in workerd (not in Node, so unit tests passed):
491// pushes were refused, and reading those files and diffs answered 500. Sizes around each limit, read
492// back through REST, a compare and a push that deltas against them.
493test("objects of every size: read back, compared and used as delta bases", async () => {
494 const owner = (await ok("GET", "/user")).login;
495 await ok("POST", "/user/repos", { name: "sizes" });
496 const src = join(work, "sizes");
497 mkdirSync(src, { recursive: true });
498 const sizes = [100, 16_385, 65_535, 65_537, 101_330, 600_000];
499 const text = (size, seed) => {
500 const lines = [];
501 for (let n = 0, i = 0; n < size; i++) {
502 const line = `${seed} line ${i}: ${(i * 7919) % 10007} ${"abcdefghij".repeat(4)}\n`;
503 lines.push(line);
504 n += line.length;
505 }
506 return lines.join("").slice(0, size);
507 };
508 for (const size of sizes) writeFileSync(join(src, `f${size}.txt`), text(size, "v1"));
509 git(src, ["init", "-q", "-b", "main"]);
510 git(src, ["add", "-A"]);
511 git(src, ["commit", "-q", "-m", "sizes"]);
512 git(src, ["remote", "add", "origin", `${base}/${owner}/sizes.git`]);
513 git(src, ["push", "-q", "origin", "main"]);
514 const first = git(src, ["rev-parse", "HEAD"]).trim();
515 for (const size of sizes) {
516 const c = await ok("GET", `/repos/${owner}/sizes/contents/f${size}.txt`);
517 assert.equal(Buffer.from(c.content, "base64").toString(), text(size, "v1"), `f${size}.txt reads back`);
518 }
519 // One changed line each: git sends deltas against the stored objects, which the server inflates.
520 for (const size of sizes) writeFileSync(join(src, `f${size}.txt`), "changed\n" + text(size, "v1").slice(8));
521 git(src, ["commit", "-q", "-am", "change"]);
522 git(src, ["push", "-q", "origin", "main"]);
523 const cmp = await ok("GET", `/repos/${owner}/sizes/compare/${first}...main`);
524 assert.equal(cmp.files.length, sizes.length);
525 await ok("GET", `/repos/${owner}/sizes/commits/main`);
526 const clone = join(work, "sizes-clone");
527 git(work, ["clone", "-q", `${base}/${owner}/sizes.git`, clone]);
528 git(clone, ["fsck", "--no-progress"]);
529 for (const size of sizes) assert.equal(readFileSync(join(clone, `f${size}.txt`), "utf8"), readFileSync(join(src, `f${size}.txt`), "utf8"));
530});
531
532test("reusable workflows: inputs, secrets, outputs, nesting and skipped calls", async () => {
533 const owner = (await ok("GET", "/user")).login;
534 await ok("POST", "/user/repos", { name: "reuse" });
535 await api("PUT", `/repos/${owner}/reuse/actions/secrets/TOPSECRET`, { value: "s3cret" });
536 const src = join(work, "reuse");
537 mkdirSync(join(src, ".github/workflows"), { recursive: true });
538 writeFileSync(
539 join(src, ".github/workflows/lib.yml"),
540 `on:
541 workflow_call:
542 inputs:
543 greeting: { type: string, required: true }
544 loud: { type: boolean, default: false }
545 secrets:
546 TOPSECRET: { required: true }
547 outputs:
548 word:
549 value: \${{ jobs.shout.outputs.word }}
550jobs:
551 say:
552 runs-on: [self-hosted, linux]
553 outputs:
554 word: \${{ steps.s.outputs.word }}
555 steps:
556 - id: s
557 run: echo "word=\${{ inputs.greeting }}-there" >> "$GITHUB_OUTPUT"
558 - run: echo "secret ok=\${{ secrets.TOPSECRET == 's3cret' }} loud=\${{ inputs.loud }} job=\${{ github.job }}"
559 shout:
560 needs: say
561 runs-on: [self-hosted, linux]
562 outputs:
563 word: \${{ steps.s.outputs.word }}
564 steps:
565 - id: s
566 run: echo "word=\${{ needs.say.outputs.word }}!" >> "$GITHUB_OUTPUT"
567`,
568 );
569 writeFileSync(
570 join(src, ".github/workflows/main.yml"),
571 `name: Main
572on: push
573jobs:
574 call:
575 name: Greeter
576 uses: ./.github/workflows/lib.yml
577 with:
578 greeting: \${{ github.event_name == 'push' && 'hi' || 'no' }}
579 loud: true
580 secrets: inherit
581 nope:
582 if: \${{ false }}
583 uses: ./.github/workflows/lib.yml
584 with:
585 greeting: never
586 secrets:
587 TOPSECRET: \${{ secrets.TOPSECRET }}
588 after:
589 needs: [call, nope]
590 if: \${{ always() }}
591 runs-on: [self-hosted, linux]
592 steps:
593 - run: echo "got=\${{ needs.call.outputs.word }} call=\${{ needs.call.result }} nope=\${{ needs.nope.result }}"
594`,
595 );
596 git(src, ["init", "-q", "-b", "main"]);
597 git(src, ["add", "."]);
598 git(src, ["commit", "-q", "-m", "reusable"]);
599 git(src, ["remote", "add", "origin", `${base}/${owner}/reuse.git`]);
600 git(src, ["push", "-q", "origin", "main"]);
601
602 const run = await until("reuse run", async () => (await ok("GET", `/repos/${owner}/reuse/actions/runs`)).workflow_runs[0]);
603 const logOf = async (id) => (await fetch(`${base}/api/v3/repos/${owner}/reuse/actions/jobs/${id}/logs`, { headers: { authorization: `Bearer ${token}` } })).text();
604 const say = await runOneJob(owner, "reuse");
605 assert.equal(say.claim.name, "Greeter / say");
606 const sayLog = await logOf(say.claim.job_id);
607 assert.match(sayLog, /secret ok=true loud=true job=say/);
608 assert.doesNotMatch(sayLog, /s3cret/);
609 const shout = await runOneJob(owner, "reuse");
610 assert.equal(shout.claim.name, "Greeter / shout");
611 const after = await runOneJob(owner, "reuse");
612 assert.equal(after.claim.name, "after");
613 assert.match(await logOf(after.claim.job_id), /got=hi-there! call=success nope=skipped/);
614 const done = await until("reuse run to complete", async () => {
615 const r = await ok("GET", `/repos/${owner}/reuse/actions/runs/${run.id}`);
616 return r.status === "completed" ? r : null;
617 });
618 assert.equal(done.conclusion, "success");
619 const jobs = (await ok("GET", `/repos/${owner}/reuse/actions/runs/${run.id}/jobs`)).jobs;
620 assert.deepEqual(jobs.filter((j) => j.conclusion === "skipped").map((j) => j.name).sort(), ["nope / say", "nope / shout"]);
621});
622
623test("job graph: needs-only scheduling, skip cascades, per-leg runs-on, continue-on-error, job concurrency and public payloads", async () => {
624 const owner = (await ok("GET", "/user")).login;
625 await ok("POST", "/user/repos", { name: "graph", private: false });
626 const src = join(work, "graph");
627 mkdirSync(join(src, ".github/workflows"), { recursive: true });
628 writeFileSync(
629 join(src, ".github/workflows/graph.yml"),
630 `name: Graph
631on: push
632jobs:
633 slow:
634 runs-on: [self-hosted, e2e-slow]
635 steps:
636 - run: echo slow
637 fast:
638 runs-on: [self-hosted, linux]
639 steps:
640 - run: echo "private=\${{ github.event.repository.private }} visibility=\${{ github.event.repository.visibility }}"
641 after-fast:
642 needs: fast
643 runs-on: [self-hosted, linux]
644 steps:
645 - run: echo after-fast
646 gate:
647 if: \${{ github.event_name == 'nope' }}
648 runs-on: [self-hosted, linux]
649 steps:
650 - run: echo never
651 middle:
652 needs: gate
653 if: \${{ always() }}
654 runs-on: [self-hosted, linux]
655 steps:
656 - run: echo "gate=\${{ needs.gate.result }}"
657 leaf:
658 needs: middle
659 runs-on: [self-hosted, linux]
660 steps:
661 - run: echo leaf
662 rescued:
663 needs: middle
664 if: \${{ !cancelled() && !failure() }}
665 runs-on: [self-hosted, linux]
666 steps:
667 - run: echo "middle=\${{ needs.middle.result }}"
668 lanes:
669 name: lane \${{ matrix.lane }}
670 strategy:
671 matrix:
672 include:
673 - lane: red
674 runner: [self-hosted, e2e-red]
675 - lane: blue
676 runner: [self-hosted, e2e-blue]
677 runs-on: \${{ matrix.runner }}
678 continue-on-error: \${{ matrix.lane == 'red' }}
679 environment: e2e-\${{ matrix.lane }}-\${{ strategy.job-total }}
680 steps:
681 - run: echo "lane=\${{ matrix.lane }}" && test "\${{ matrix.lane }}" = blue
682 after-lanes:
683 needs: lanes
684 runs-on: [self-hosted, linux]
685 steps:
686 - run: echo "lanes=\${{ needs.lanes.result }}"
687 deploy:
688 strategy:
689 matrix:
690 target: [prod, staging]
691 concurrency: e2e-\${{ matrix.target }}
692 runs-on: [self-hosted, e2e-deploy]
693 steps:
694 - run: echo "deploy \${{ matrix.target }}"
695 hotfix:
696 strategy:
697 matrix:
698 target: [prod]
699 concurrency: e2e-\${{ matrix.target }}
700 runs-on: [self-hosted, e2e-deploy]
701 steps:
702 - run: echo "hotfix \${{ matrix.target }}"
703`,
704 );
705 git(src, ["init", "-q", "-b", "main"]);
706 git(src, ["add", "."]);
707 git(src, ["commit", "-q", "-m", "graph"]);
708 git(src, ["remote", "add", "origin", `${base}/${owner}/graph.git`]);
709 git(src, ["push", "-q", "origin", "main"]);
710
711 const run = await until("graph run", async () => (await ok("GET", `/repos/${owner}/graph/actions/runs`)).workflow_runs[0]);
712 const logOf = async (id) => (await fetch(`${base}/api/v3/repos/${owner}/graph/actions/jobs/${id}/logs`, { headers: { authorization: `Bearer ${token}` } })).text();
713 const jobs = async () => (await ok("GET", `/repos/${owner}/graph/actions/runs/${run.id}/jobs`)).jobs;
714
715 // Jobs start when their own needs finish: after-fast and rescued run while slow (no runner offers e2e-slow) still waits.
716 const linux = {};
717 for (let i = 0; i < 4; i++) {
718 const j = await runOneJob(owner, "graph");
719 linux[j.claim.name] = j.claim.job_id;
720 }
721 assert.deepEqual(Object.keys(linux).sort(), ["after-fast", "fast", "middle", "rescued"]);
722 assert.equal((await jobs()).find((j) => j.name === "slow").status, "waiting");
723 assert.match(await logOf(linux.fast), /private=false visibility=public/);
724 assert.match(await logOf(linux.middle), /gate=skipped/);
725 assert.match(await logOf(linux.rescued), /middle=success/);
726
727 // runs-on per matrix leg; the red leg fails but continues on error, so fail-fast spares the blue one.
728 const red = await runOneJob(owner, "graph", { labels: ["e2e-red"], allowFailure: true });
729 assert.equal(red.claim.name, "lane red");
730 const blue = await runOneJob(owner, "graph", { labels: ["e2e-blue"] });
731 assert.equal(blue.claim.name, "lane blue");
732 const afterLanes = await runOneJob(owner, "graph");
733 assert.equal(afterLanes.claim.name, "after-lanes");
734 assert.match(await logOf(afterLanes.claim.job_id), /lanes=success/);
735 const envs = (await ok("GET", `/repos/${owner}/graph/environments`)).environments.map((e) => e.name);
736 assert.ok(envs.includes("e2e-red-2") && envs.includes("e2e-blue-2"), `per-leg environments: ${envs}`);
737
738 // Job-level concurrency, evaluated per leg: one of the two prod jobs waits as pending until the other finishes.
739 const pending = await until("a pending prod job", async () => (await jobs()).find((j) => j.status === "pending"));
740 assert.ok(["deploy (prod)", "hotfix (prod)"].includes(pending.name), pending.name);
741 const first = await runOneJob(owner, "graph", { labels: ["e2e-deploy"] });
742 const second = await runOneJob(owner, "graph", { labels: ["e2e-deploy"] });
743 assert.deepEqual([first.claim.name, second.claim.name].sort(), ["deploy (prod)", "deploy (staging)", "hotfix (prod)"].filter((n) => n !== pending.name).sort());
744 const third = await runOneJob(owner, "graph", { labels: ["e2e-deploy"] });
745 assert.equal(third.claim.name, pending.name);
746
747 const slow = await runOneJob(owner, "graph", { labels: ["e2e-slow"] });
748 assert.equal(slow.claim.name, "slow");
749 const done = await until("graph run to complete", async () => {
750 const r = await ok("GET", `/repos/${owner}/graph/actions/runs/${run.id}`);
751 return r.status === "completed" ? r : null;
752 });
753 assert.equal(done.conclusion, "success", "a failed leg with continue-on-error does not fail the run");
754 const byName = Object.fromEntries((await jobs()).map((j) => [j.name, j]));
755 assert.equal(byName.gate.conclusion, "skipped");
756 assert.equal(byName.leaf.conclusion, "skipped", "a skipped ancestor skips the jobs below it");
757 assert.equal(byName["lane red"].conclusion, "failure");
758 assert.equal(byName["lane blue"].conclusion, "success");
759});
760
761test("re-runs: failed jobs only keep what passed, and one job re-runs with what depends on it", async () => {
762 const owner = (await ok("GET", "/user")).login;
763 await ok("POST", "/user/repos", { name: "rerun", private: true });
764 const src = join(work, "rerun");
765 mkdirSync(join(src, ".github/workflows"), { recursive: true });
766 writeFileSync(
767 join(src, ".github/workflows/rerun.yml"),
768 `name: Rerun
769on: push
770jobs:
771 build:
772 runs-on: [self-hosted, linux]
773 steps:
774 - run: echo "built in attempt \${{ github.run_attempt }}"
775 test:
776 needs: build
777 strategy:
778 matrix:
779 n: [1, 2]
780 runs-on: [self-hosted, linux]
781 steps:
782 - run: echo "leg \${{ matrix.n }}" && { test "\${{ matrix.n }}" = 1 || test "\${{ github.run_attempt }}" != 1; }
783 report:
784 needs: test
785 runs-on: [self-hosted, linux]
786 steps:
787 - run: echo "report in attempt \${{ github.run_attempt }}"
788`,
789 );
790 git(src, ["init", "-q", "-b", "main"]);
791 git(src, ["add", "."]);
792 git(src, ["commit", "-q", "-m", "rerun"]);
793 git(src, ["remote", "add", "origin", `${base}/${owner}/rerun.git`]);
794 git(src, ["push", "-q", "origin", "main"]);
795 const R = `/repos/${owner}/rerun`;
796 const finished = (id) =>
797 until(`run ${id} to complete`, async () => {
798 const r = await ok("GET", `${R}/actions/runs/${id}`);
799 return r.status === "completed" ? r : null;
800 });
801 const jobsOf = async (id) => Object.fromEntries((await ok("GET", `${R}/actions/runs/${id}/jobs`)).jobs.map((j) => [j.name, j]));
802 const logOf = async (id) => (await fetch(`${base}/api/v3${R}/actions/jobs/${id}/logs`, { headers: { authorization: `Bearer ${token}` } })).text();
803
804 // Attempt 1: leg 2 fails, so report is skipped.
805 const first = await until("the first run", async () => (await ok("GET", `${R}/actions/runs`)).workflow_runs[0]);
806 const claimed = [];
807 for (let i = 0; i < 3; i++) claimed.push((await runOneJob(owner, "rerun", { allowFailure: true })).claim.name);
808 assert.deepEqual(claimed, ["build", "test (1)", "test (2)"]);
809 assert.equal((await finished(first.id)).conclusion, "failure");
810 assert.equal((await jobsOf(first.id)).report.conclusion, "skipped");
811
812 // Re-run failed jobs: build and leg 1 are kept as they were; leg 2 and report run again.
813 const second = (await api("POST", `${R}/actions/runs/${first.id}/rerun-failed-jobs`, { enable_debug_logging: false })).json.run_id;
814 assert.ok(second);
815 const again = [];
816 for (let i = 0; i < 2; i++) again.push((await runOneJob(owner, "rerun")).claim.name);
817 assert.deepEqual(again, ["test (2)", "report"]);
818 const done = await finished(second);
819 assert.deepEqual([done.conclusion, done.run_attempt, done.run_number], ["success", 2, first.run_number]);
820 const kept = await jobsOf(second);
821 const before = await jobsOf(first.id);
822 assert.equal(kept.build.carriedFrom, before.build.id);
823 assert.equal(kept["test (1)"].carriedFrom, before["test (1)"].id);
824 assert.equal(kept["test (2)"].carriedFrom, null);
825 assert.match(await logOf(kept.build.id), /built in attempt 1/);
826 assert.match(await logOf(kept.report.id), /report in attempt 2/);
827 assert.equal((await runnerClaim(R, ["linux"])).status, 204, "nothing else waits for a runner");
828
829 // Nothing failed any more; re-running one job runs it and what depends on it (nothing here), keeping the rest.
830 const none = await api("POST", `${R}/actions/runs/${second}/rerun-failed-jobs`);
831 assert.deepEqual([none.status, none.json.message], [409, "this run has no failed jobs to re-run"]);
832 const third = (await ok("POST", `${R}/actions/jobs/${kept.report.id}/rerun`)).run_id;
833 assert.equal((await runOneJob(owner, "rerun")).claim.name, "report");
834 assert.equal((await finished(third)).conclusion, "success");
835 const last = await jobsOf(third);
836 assert.equal(last.build.carriedFrom, before.build.id, "a job kept twice points at the job that ran");
837 assert.equal(last["test (2)"].carriedFrom, kept["test (2)"].id);
838 assert.equal(last.report.carriedFrom, null);
839});
840
841test("workflow_run: a workflow follows another one on the default branch", async () => {
842 const owner = (await ok("GET", "/user")).login;
843 await ok("POST", "/user/repos", { name: "chain" });
844 const src = join(work, "chain");
845 mkdirSync(join(src, ".github/workflows"), { recursive: true });
846 writeFileSync(join(src, ".github/workflows/ci.yml"), `name: CI\non: push\njobs:\n build:\n runs-on: [self-hosted, linux]\n steps:\n - run: echo built\n`);
847 writeFileSync(
848 join(src, ".github/workflows/after.yml"),
849 `name: After CI
850on:
851 workflow_run:
852 workflows: [CI]
853 types: [completed]
854 branches: [main]
855jobs:
856 report:
857 if: \${{ github.event.workflow_run.conclusion == 'success' }}
858 runs-on: [self-hosted, linux]
859 steps:
860 - run: echo "followed \${{ github.event.workflow_run.name }} on \${{ github.event.workflow_run.head_branch }} (\${{ github.event.action }}) ref=\${{ github.ref }}"
861`,
862 );
863 git(src, ["init", "-q", "-b", "main"]);
864 git(src, ["add", "."]);
865 git(src, ["commit", "-q", "-m", "chain"]);
866 git(src, ["remote", "add", "origin", `${base}/${owner}/chain.git`]);
867 git(src, ["push", "-q", "origin", "main"]);
868
869 const runs = async () => (await ok("GET", `/repos/${owner}/chain/actions/runs`)).workflow_runs;
870 await until("CI run", async () => (await runs()).find((r) => r.name === "CI"));
871 assert.equal((await runs()).length, 1, "only CI runs before it completes");
872 const build = await runOneJob(owner, "chain");
873 assert.equal(build.claim.name, "build");
874 const follower = await until("follower run", async () => (await runs()).find((r) => r.event === "workflow_run"));
875 assert.equal(follower.name, "After CI");
876 assert.equal(follower.head_branch, "main");
877 const report = await runOneJob(owner, "chain");
878 assert.equal(report.claim.name, "report");
879 const log = await (await fetch(`${base}/api/v3/repos/${owner}/chain/actions/jobs/${report.claim.job_id}/logs`, { headers: { authorization: `Bearer ${token}` } })).text();
880 assert.match(log, /followed CI on main \(completed\) ref=refs\/heads\/main/);
881 const done = await until("follower to complete", async () => {
882 const r = await ok("GET", `/repos/${owner}/chain/actions/runs/${follower.id}`);
883 return r.status === "completed" ? r : null;
884 });
885 assert.equal(done.conclusion, "success");
886 assert.equal((await runs()).length, 2, "the follower does not trigger itself");
887
888 // A run whose jobs were all skipped is skipped, as on GitHub, so a follower that waits for success doesn't run.
889 writeFileSync(join(src, ".github/workflows/ci.yml"), `name: CI\non: push\njobs:\n build:\n if: \${{ false }}\n runs-on: [self-hosted, linux]\n steps:\n - run: echo built\n`);
890 git(src, ["commit", "-q", "-am", "skip the build"]);
891 git(src, ["push", "-q", "origin", "main"]);
892 const settled = await until("skipped CI and its follower", async () => {
893 const all = await runs();
894 return all.length === 4 && all.every((r) => r.status === "completed") ? all : null;
895 });
896 const sha = git(src, ["rev-parse", "HEAD"]).trim();
897 const skippedCi = settled.find((r) => r.name === "CI" && r.head_sha === sha);
898 assert.equal(skippedCi?.conclusion, "skipped");
899 assert.equal(settled.find((r) => r.event === "workflow_run" && r.id !== follower.id)?.conclusion, "skipped");
900});
901
902test("triggers from workflows: a job's repository_dispatch starts runs, a follower of agent code stays an agent's", { timeout: 600_000 }, async () => {
903 const owner = (await ok("GET", "/user")).login;
904 await ok("POST", "/user/repos", { name: "relay" });
905 const bot = (await ok("POST", "/diffinery/agents", { login: "relay-bot" }, null)).token.token;
906 const src = join(work, "relay");
907 mkdirSync(join(src, ".github/workflows"), { recursive: true });
908 writeFileSync(
909 join(src, ".github/workflows/send.yml"),
910 `name: Send
911on: workflow_dispatch
912jobs:
913 send:
914 runs-on: [self-hosted, linux]
915 permissions: { contents: write }
916 steps:
917 - env: { GH_TOKEN: "\${{ github.token }}" }
918 run: |
919 code=$(curl -s -o out.txt -w '%{http_code}' -X POST -H "authorization: Bearer $GH_TOKEN" -H 'content-type: application/json' -d '{"event_type":"ping","client_payload":{"from":"a job"}}' "$GITHUB_API_URL/repos/$GITHUB_REPOSITORY/dispatches")
920 echo "dispatch: $code $(cat out.txt)"
921`,
922 );
923 writeFileSync(
924 join(src, ".github/workflows/pinged.yml"),
925 `name: Pinged
926on:
927 repository_dispatch:
928 types: [ping]
929jobs:
930 pinged:
931 runs-on: [self-hosted, linux]
932 steps:
933 - run: echo "pinged from \${{ github.event.client_payload.from }}"
934`,
935 );
936 writeFileSync(join(src, ".github/workflows/ci.yml"), `name: CI\non: pull_request\njobs:\n build:\n runs-on: [self-hosted, linux]\n steps:\n - run: echo built\n`);
937 writeFileSync(
938 join(src, ".github/workflows/after.yml"),
939 `name: After CI
940on:
941 workflow_run:
942 workflows: [CI]
943 types: [completed]
944jobs:
945 follow:
946 runs-on: [self-hosted, linux]
947 permissions: { contents: write }
948 steps:
949 - uses: actions/checkout@v4
950 with: { ref: main }
951 - env:
952 GIT_AUTHOR_NAME: bot
953 GIT_AUTHOR_EMAIL: bot@example.com
954 GIT_COMMITTER_NAME: bot
955 GIT_COMMITTER_EMAIL: bot@example.com
956 run: |
957 echo "after \${{ github.event.workflow_run.head_branch }}" >> followed.txt
958 git add followed.txt && git commit -qm followed
959 if git push -q origin HEAD:main 2>err.txt; then echo "main push: ok"; else echo "main push: refused $(tr '\\n' ' ' < err.txt)"; fi
960`,
961 );
962 git(src, ["init", "-q", "-b", "main"]);
963 git(src, ["add", "."]);
964 git(src, ["commit", "-q", "-m", "relay"]);
965 git(src, ["remote", "add", "origin", `${base}/${owner}/relay.git`]);
966 git(src, ["push", "-q", "origin", "main"]);
967
968 const runs = async () => (await ok("GET", `/repos/${owner}/relay/actions/runs`)).workflow_runs;
969 const logOf = async (claim) => (await (await fetch(`${base}/api/v3/repos/${owner}/relay/actions/jobs/${claim.job_id}/logs`, { headers: { authorization: `Bearer ${token}` } })).text()).replace(/^\S+Z /gm, "");
970
971 // Like GitHub, a job's GITHUB_TOKEN may send repository_dispatch, and that starts runs.
972 await ok("POST", `/repos/${owner}/relay/actions/workflows/send.yml/dispatches`, { ref: "main" });
973 const send = await runOneJob(owner, "relay");
974 assert.equal(send.claim.name, "send");
975 assert.match(await logOf(send.claim), /dispatch: 204/);
976 const pingedRun = await until("repository_dispatch run", async () => (await runs()).find((r) => r.event === "repository_dispatch"));
977 assert.equal(pingedRun.name, "Pinged");
978 const pinged = await runOneJob(owner, "relay");
979 assert.equal(pinged.claim.name, "pinged");
980 assert.match(await logOf(pinged.claim), /pinged from a job/);
981
982 /** Opens a pull request from `branch` as a person, runs its CI, then the follower; returns the follower's log. */
983 const follow = async (branch) => {
984 const seen = new Set((await runs()).map((r) => r.id));
985 await ok("POST", `/repos/${owner}/relay/pulls`, { title: branch, head: branch, base: "main" });
986 await until("CI run", async () => (await runs()).find((r) => !seen.has(r.id) && r.name === "CI"));
987 const build = await runOneJob(owner, "relay");
988 assert.equal(build.claim.name, "build");
989 await until("follower run", async () => (await runs()).find((r) => !seen.has(r.id) && r.event === "workflow_run"));
990 const f = await runOneJob(owner, "relay");
991 assert.equal(f.claim.name, "follow");
992 return logOf(f.claim);
993 };
994
995 // A person's pull request: the follower writes to main with the token it was granted.
996 git(src, ["checkout", "-q", "-b", "person-work"]);
997 writeFileSync(join(src, "person.txt"), "from a person\n");
998 git(src, ["add", "person.txt"]);
999 git(src, ["commit", "-q", "-m", "person change"]);
1000 git(src, ["push", "-q", "origin", "person-work"]);
1001 assert.match(await follow("person-work"), /main push: ok/);
1002
1003 // A person opens a pull request from a branch an agent pushed. CI runs the agent's code, so
1004 // the follower, which acts on what CI produced, is an agent's too and may not push to main.
1005 const agentClone = join(work, "relay-agent");
1006 git(work, ["clone", "-q", `${base}/${owner}/relay.git`, agentClone], bot);
1007 git(agentClone, ["checkout", "-q", "-b", "agent-work"], bot);
1008 writeFileSync(join(agentClone, "agent.txt"), "from the agent\n");
1009 git(agentClone, ["add", "agent.txt"], bot);
1010 git(agentClone, ["commit", "-q", "-m", "agent change"], bot);
1011 git(agentClone, ["push", "-q", "origin", "agent-work"], bot);
1012 assert.match(await follow("agent-work"), /main push: refused .*agents may not push to protected or default branches/);
1013});
1014
1015test("pull requests: test merge commits, pull_request_target and the merge queue", async () => {
1016 const owner = (await ok("GET", "/user")).login;
1017 await ok("POST", "/user/repos", { name: "queue" });
1018 await api("PUT", `/repos/${owner}/queue/actions/secrets/TOPSECRET`, { value: "s3cret" });
1019 const src = join(work, "queue");
1020 mkdirSync(join(src, ".github/workflows"), { recursive: true });
1021 writeFileSync(join(src, "app.txt"), "a\nb\nc\n");
1022 writeFileSync(
1023 join(src, ".github/workflows/ci.yml"),
1024 `name: CI
1025on:
1026 pull_request:
1027 merge_group:
1028jobs:
1029 test:
1030 runs-on: [self-hosted, linux]
1031 steps:
1032 - uses: actions/checkout@v4
1033 - run: |
1034 echo "event=\${{ github.event_name }} ref=\${{ github.ref }} sha=\${{ github.sha }} head=$(git rev-parse HEAD)"
1035 echo "parents=$(git rev-list --parents -n1 HEAD)"
1036 echo "app=$(tr '\\n' ' ' < app.txt)"
1037 if [ "\${{ github.event_name }}" = merge_group ] && grep -qs fail notes.txt; then echo "merge group failed"; exit 1; fi
1038`,
1039 );
1040 writeFileSync(
1041 join(src, ".github/workflows/target.yml"),
1042 `name: Target
1043on: pull_request_target
1044jobs:
1045 t:
1046 runs-on: [self-hosted, linux]
1047 steps:
1048 - run: echo "target from base secret=\${{ secrets.TOPSECRET == 's3cret' }} ref=\${{ github.ref }} head=\${{ github.event.pull_request.head.sha }}"
1049`,
1050 );
1051 git(src, ["init", "-q", "-b", "main"]);
1052 git(src, ["add", "."]);
1053 git(src, ["commit", "-q", "-m", "queue"]);
1054 git(src, ["remote", "add", "origin", `${base}/${owner}/queue.git`]);
1055 git(src, ["push", "-q", "origin", "main"]);
1056 const root = git(src, ["rev-parse", "HEAD"]).trim();
1057
1058 // f1 changes the first line and tries to rewrite the pull_request_target workflow.
1059 git(src, ["checkout", "-q", "-b", "f1"]);
1060 writeFileSync(join(src, "app.txt"), "A\nb\nc\n");
1061 writeFileSync(join(src, ".github/workflows/target.yml"), `name: Target\non: pull_request_target\njobs:\n t:\n runs-on: [self-hosted, linux]\n steps:\n - run: echo "PWNED \${{ secrets.TOPSECRET }}"\n`);
1062 git(src, ["commit", "-q", "-am", "f1"]);
1063 git(src, ["push", "-q", "origin", "f1"]);
1064 const f1 = git(src, ["rev-parse", "HEAD"]).trim();
1065 // main moves on, so the test merge commit differs from both sides.
1066 git(src, ["checkout", "-q", "main"]);
1067 writeFileSync(join(src, "app.txt"), "a\nb\nC\n");
1068 git(src, ["commit", "-q", "-am", "main moves"]);
1069 git(src, ["push", "-q", "origin", "main"]);
1070 const main1 = git(src, ["rev-parse", "HEAD"]).trim();
1071
1072 const pr1 = await ok("POST", `/repos/${owner}/queue/pulls`, { title: "Capitalise a", head: "f1", base: "main" });
1073 const runs = async (q = "") => (await ok("GET", `/repos/${owner}/queue/actions/runs${q}`)).workflow_runs;
1074 const prRun = await until("pull_request run", async () => (await runs("?event=pull_request"))[0]);
1075 assert.equal(prRun.ref, "refs/pull/1/merge");
1076 assert.equal(prRun.head_sha, f1, "pull_request runs report on the PR head");
1077 assert.notEqual(prRun.sha, f1, "pull_request runs check out the test merge commit");
1078 assert.equal(prRun.head_branch, "f1");
1079 const targetRun = (await runs("?event=pull_request_target"))[0];
1080 assert.equal(targetRun.ref, "refs/heads/main");
1081 assert.equal(targetRun.sha, main1, "pull_request_target runs on the base commit");
1082 assert.equal(targetRun.head_sha, f1);
1083 // The merge ref is fetchable and its parents are [base, head]; refs/pull is read-only.
1084 git(src, ["fetch", "-q", "origin", "+refs/pull/1/merge:refs/remotes/pr/1"]);
1085 assert.equal(git(src, ["rev-parse", "refs/remotes/pr/1"]).trim(), prRun.sha);
1086 assert.equal(git(src, ["rev-list", "--parents", "-n1", "refs/remotes/pr/1"]).trim(), `${prRun.sha} ${main1} ${f1}`);
1087 assert.match(gitFails(src, ["push", "origin", `${root}:refs/pull/1/head`]), /refs\/pull|managed/);
1088
1089 const logOf = async (id) => (await fetch(`${base}/api/v3/repos/${owner}/queue/actions/jobs/${id}/logs`, { headers: { authorization: `Bearer ${token}` } })).text();
1090 const ran = {};
1091 for (let i = 0; i < 2; i++) {
1092 const j = await runOneJob(owner, "queue");
1093 ran[j.claim.name] = await logOf(j.claim.job_id);
1094 }
1095 assert.match(ran.test, new RegExp(`event=pull_request ref=refs/pull/1/merge sha=${prRun.sha} head=${prRun.sha}`));
1096 assert.match(ran.test, /app=A b C/);
1097 assert.match(ran.t, /target from base secret=true ref=refs\/heads\/main/);
1098 assert.match(ran.t, new RegExp(`head=${f1}`));
1099 assert.doesNotMatch(ran.t, /PWNED/);
1100 await until("PR #1 checks", async () => {
1101 const c = (await ok("GET", `/repos/${owner}/queue/commits/${f1}/check-runs`)).check_runs;
1102 return c.length === 2 && c.every((x) => x.conclusion === "success") ? c : null;
1103 });
1104
1105 // ------------------------------------------------------------ merge queue
1106 await ok("PUT", `/repos/${owner}/queue/branches/main/protection`, { requirePullRequest: true, requiredChecks: ["CI / test"], mergeQueue: { method: "merge", buildConcurrency: 5, checkTimeoutMinutes: 30 } });
1107 const direct = await api("PUT", `/repos/${owner}/queue/pulls/1/merge`, {});
1108 assert.equal(direct.status, 405);
1109 assert.match(JSON.stringify(direct.json), /merge queue/);
1110 assert.equal((await ok("GET", `/repos/${owner}/queue/pulls/1/merge`)).mergeQueue.method, "merge");
1111
1112 // Two more pull requests: one that merges cleanly and one that fails only in its merge group.
1113 const branch = async (name, file, content) => {
1114 git(src, ["checkout", "-q", "-b", name, main1]);
1115 writeFileSync(join(src, file), content);
1116 git(src, ["add", "."]);
1117 git(src, ["commit", "-q", "-m", name]);
1118 git(src, ["push", "-q", "origin", name]);
1119 const sha = git(src, ["rev-parse", "HEAD"]).trim();
1120 const pr = await ok("POST", `/repos/${owner}/queue/pulls`, { title: name, head: name, base: "main" });
1121 for (let i = 0; i < 2; i++) await runOneJob(owner, "queue");
1122 await until(`${name} checks`, async () => (await ok("GET", `/repos/${owner}/queue/commits/${sha}/check-runs`)).check_runs.filter((x) => x.conclusion === "success").length === 2);
1123 return { pr, sha };
1124 };
1125 const f2 = await branch("f2", "two.txt", "two\n");
1126 const f3 = await branch("f3", "notes.txt", "fail\n");
1127
1128 const q1 = await ok("PUT", `/repos/${owner}/queue/pulls/1/merge-queue`, { delete_branch: true });
1129 assert.equal(q1.state, "queued");
1130 assert.equal(q1.entry.position, 1);
1131 assert.equal(q1.entry.state, "checking");
1132 const q2 = await ok("PUT", `/repos/${owner}/queue/pulls/${f2.pr.number}/merge-queue`, {});
1133 const q3 = await ok("PUT", `/repos/${owner}/queue/pulls/${f3.pr.number}/merge-queue`, {});
1134 assert.equal(q2.entry.merge_group.base_sha, q1.entry.merge_group.head_sha, "each group builds on the one ahead");
1135 assert.equal(q3.entry.merge_group.base_sha, q2.entry.merge_group.head_sha);
1136 assert.equal(q1.entry.merge_group.head_ref, `refs/heads/gh-readonly-queue/main/pr-1-${f1}`);
1137 const queue = await ok("GET", `/repos/${owner}/queue/merge-queue/main`);
1138 assert.deepEqual(queue.entries.map((e) => e.number), [1, f2.pr.number, f3.pr.number]);
1139 assert.match(gitFails(src, ["push", "origin", `${root}:refs/heads/gh-readonly-queue/main/x`]), /read-only/);
1140
1141 // Merge groups run merge_group workflows, oldest first.
1142 const groupLogs = [];
1143 for (let i = 0; i < 3; i++) {
1144 const j = await runOneJob(owner, "queue", { allowFailure: i === 2 });
1145 groupLogs.push(await logOf(j.claim.job_id));
1146 }
1147 assert.match(groupLogs[0], new RegExp(`event=merge_group ref=refs/heads/gh-readonly-queue/main/pr-1-${f1} sha=${q1.entry.merge_group.head_sha}`));
1148 assert.match(groupLogs[2], /merge group failed/);
1149 const mainNow = await until("the queue to merge #1 and #2", async () => {
1150 const b = await ok("GET", `/repos/${owner}/queue/branches/main`);
1151 return b.commit.sha === q2.entry.merge_group.head_sha ? b : null;
1152 });
1153 assert.ok(mainNow);
1154 assert.equal((await ok("GET", `/repos/${owner}/queue/pulls/1`)).merged, true);
1155 assert.equal((await ok("GET", `/repos/${owner}/queue/pulls/${f2.pr.number}`)).merged, true);
1156 assert.equal((await ok("GET", `/repos/${owner}/queue/pulls/1`)).merge_commit_sha, q1.entry.merge_group.head_sha, "the tested commit is what merged");
1157 const f3After = await until("#3 to leave the queue", async () => {
1158 const q = await ok("GET", `/repos/${owner}/queue/merge-queue/main`);
1159 return q.entries.length === 0 ? q : null;
1160 });
1161 assert.ok(f3After);
1162 assert.equal((await ok("GET", `/repos/${owner}/queue/pulls/${f3.pr.number}`)).merged, false);
1163 const comments = await ok("GET", `/repos/${owner}/queue/issues/${f3.pr.number}/comments`);
1164 assert.match(JSON.stringify(comments), /removed from the merge queue: the required check 'CI \/ test' failed on its merge group/);
1165 git(src, ["fetch", "-q", "origin"]);
1166 assert.equal(git(src, ["show", "origin/main:app.txt"]), "A\nb\nC\n");
1167 assert.equal(git(src, ["show", "origin/main:two.txt"]), "two\n");
1168 assert.ok(!(await ok("GET", `/repos/${owner}/queue/branches`)).some((b) => b.name.startsWith("gh-readonly-queue/") || b.name === "f1"), "group branches and f1 are gone");
1169
1170 // A pull request that conflicts with its base runs no pull_request workflows (like GitHub), only pull_request_target.
1171 git(src, ["checkout", "-q", "-b", "f4", root]);
1172 writeFileSync(join(src, "app.txt"), "x\nb\nc\n");
1173 git(src, ["commit", "-q", "-am", "f4"]);
1174 git(src, ["push", "-q", "origin", "f4"]);
1175 const pr4 = await ok("POST", `/repos/${owner}/queue/pulls`, { title: "conflicts", head: "f4", base: "main" });
1176 const t4 = await until("pull_request_target run for #4", async () => (await runs("?event=pull_request_target")).find((r) => r.pull_request_number === pr4.number));
1177 assert.ok(t4);
1178 assert.equal((await runs("?event=pull_request")).filter((r) => r.pull_request_number === pr4.number).length, 0);
1179 await runOneJob(owner, "queue");
1180
1181 // The web UI shows the queue.
1182 const page = async (path) => {
1183 const res = await fetch(`${base}${path}`);
1184 assert.equal(res.status, 200, path);
1185 return res.text();
1186 };
1187 assert.match(await page(`/${owner}/queue/queue/main`), /The queue is empty/);
1188 assert.match(await page(`/${owner}/queue/pull/${pr4.number}`), /Merge when ready/);
1189 assert.match(await page(`/${owner}/queue/pull/${f3.pr.number}`), /removed from the merge queue/);
1190 assert.match(await page(`/${owner}/queue/settings/branches`), /merge queue/);
1191});
1192
1193const POLICY_WORKFLOW = `name: Policy
1194on:
1195 push:
1196 branches: [main, agent-work]
1197 pull_request:
1198jobs:
1199 probe:
1200 runs-on: [self-hosted, linux]
1201 permissions: { contents: write, pull-requests: write }
1202 steps:
1203 - uses: actions/checkout@v4
1204 with: { ref: main }
1205 - name: Push to main, push a workflow change, approve the pull request
1206 env:
1207 GH_TOKEN: \${{ github.token }}
1208 PR: \${{ github.event.pull_request.number }}
1209 GIT_AUTHOR_NAME: bot
1210 GIT_AUTHOR_EMAIL: bot@example.com
1211 GIT_COMMITTER_NAME: bot
1212 GIT_COMMITTER_EMAIL: bot@example.com
1213 run: |
1214 echo "run \${{ github.run_id }}" > note.txt
1215 git add note.txt && git commit -qm note
1216 if git push -q origin HEAD:main 2>err.txt; then echo "main push: ok"; else echo "main push: refused $(tr '\\n' ' ' < err.txt)"; fi
1217 git reset -q --hard HEAD~1
1218 echo "# edited" >> .github/workflows/policy.yml
1219 git commit -qam "edit the workflow"
1220 if git push -q origin "HEAD:refs/heads/wf-\${{ github.run_id }}" 2>err.txt; then echo "workflow push: ok"; else echo "workflow push: refused $(tr '\\n' ' ' < err.txt)"; fi
1221 if [ -n "$PR" ]; then
1222 code=$(curl -s -o out.json -w '%{http_code}' -X POST -H "authorization: Bearer $GH_TOKEN" -H 'content-type: application/json' -d '{"event":"APPROVE","body":"from a workflow"}' "$GITHUB_API_URL/repos/$GITHUB_REPOSITORY/pulls/$PR/reviews")
1223 echo "approve: $code $(cat out.json)"
1224 fi
1225 defaults:
1226 if: github.event_name == 'push' && github.ref == 'refs/heads/main'
1227 runs-on: [self-hosted, linux]
1228 steps:
1229 - env: { GH_TOKEN: "\${{ github.token }}" }
1230 run: |
1231 code=$(curl -s -o out.json -w '%{http_code}' -X POST -H "authorization: Bearer $GH_TOKEN" -H 'content-type: application/json' -d '{"title":"from the default token"}' "$GITHUB_API_URL/repos/$GITHUB_REPOSITORY/issues")
1232 echo "default token issue write: $code $(cat out.json)"
1233 code=$(curl -s -o /dev/null -w '%{http_code}' -H "authorization: Bearer $GH_TOKEN" "$GITHUB_API_URL/repos/$GITHUB_REPOSITORY/contents/README.md")
1234 echo "default token contents read: $code"
1235`;
1236
1237test("workflow tokens: read-only default, no approvals or workflow edits, agent code stays an agent", { timeout: 600_000 }, async () => {
1238 const owner = (await ok("GET", "/user")).login;
1239 await ok("POST", "/user/repos", { name: "policy" });
1240 const settingsPath = `/repos/${owner}/policy/actions/permissions/workflow`;
1241 // New repositories start like GitHub's: read-only token, no pull request approvals.
1242 assert.deepEqual(await ok("GET", settingsPath), { default_workflow_permissions: "read", can_approve_pull_request_reviews: false, agent_runs_use_secrets: false });
1243 const bot = (await ok("POST", "/diffinery/agents", { login: "policy-bot" }, null)).token.token;
1244 assert.equal((await api("PUT", settingsPath, { can_approve_pull_request_reviews: true }, bot)).status, 403, "agents cannot change what workflows may do");
1245 assert.equal((await api("PUT", settingsPath, { default_workflow_permissions: "admin" })).status, 422);
1246 // The same settings on the repository's Settings → Actions page.
1247 const actionsPage = `/${owner}/policy/settings/actions`;
1248 const form = async (fields) => {
1249 const res = await fetch(`${base}${actionsPage}`);
1250 const html = await res.text();
1251 assert.match(html, /Allow GitHub Actions to create and approve pull requests/);
1252 const csrf = /name="_csrf" value="([^"]+)"/.exec(html)?.[1];
1253 const cookie = /dfy_csrf=([^;]+)/.exec(res.headers.get("set-cookie") ?? "")?.[1];
1254 const r = await fetch(`${base}${actionsPage}`, { method: "POST", body: new URLSearchParams({ _csrf: csrf, ...fields }), redirect: "manual", headers: { cookie: `dfy_csrf=${cookie}`, "sec-fetch-site": "same-origin" } });
1255 assert.equal(r.status, 303);
1256 };
1257 await form({ default_permissions: "write", can_approve: "1" });
1258 assert.deepEqual(await ok("GET", settingsPath), { default_workflow_permissions: "write", can_approve_pull_request_reviews: true, agent_runs_use_secrets: false });
1259 await form({ default_permissions: "read" });
1260 assert.deepEqual(await ok("GET", settingsPath), { default_workflow_permissions: "read", can_approve_pull_request_reviews: false, agent_runs_use_secrets: false });
1261
1262 const src = join(work, "policy");
1263 mkdirSync(join(src, ".github/workflows"), { recursive: true });
1264 writeFileSync(join(src, "README.md"), "# policy\n");
1265 writeFileSync(join(src, ".github/workflows/policy.yml"), POLICY_WORKFLOW);
1266 git(src, ["init", "-q", "-b", "main"]);
1267 git(src, ["add", "-A"]);
1268 git(src, ["commit", "-q", "-m", "policy"]);
1269 git(src, ["remote", "add", "origin", `${base}/${owner}/policy.git`]);
1270 git(src, ["push", "-q", "origin", "main"]);
1271
1272 /** Runs `count` jobs; returns their logs by job name. */
1273 const runJobs = async (count) => {
1274 const logs = {};
1275 for (let i = 0; i < count; i++) {
1276 const { claim } = await runOneJob(owner, "policy");
1277 const raw = await (await fetch(`${base}/api/v3/repos/${owner}/policy/actions/jobs/${claim.job_id}/logs`, { headers: { authorization: `Bearer ${token}` } })).text();
1278 logs[claim.name] = raw.replace(/^\S+Z /gm, "");
1279 }
1280 return logs;
1281 };
1282 const refused = (path) => new RegExp(`workflow push: refused .*refusing to allow a GitHub App to create or update workflow \`${path.replace(/\./g, "\\.")}\` without \`workflows\` permission`);
1283
1284 // A person's push: the job token writes what it was granted, but never workflow files;
1285 // the default token (no permissions:) only reads.
1286 let logs = await runJobs(2);
1287 assert.match(logs.probe, /main push: ok/);
1288 assert.match(logs.probe, refused(".github/workflows/policy.yml"));
1289 assert.match(logs.defaults, /default token issue write: 403 .*issues: write/);
1290 assert.match(logs.defaults, /default token contents read: 200/);
1291 const branches = (await ok("GET", `/repos/${owner}/policy/branches`)).map((b) => b.name);
1292 assert.ok(!branches.some((b) => b.startsWith("wf-")), JSON.stringify(branches));
1293 git(src, ["pull", "-q", "--ff-only", "origin", "main"]);
1294 assert.match(readFileSync(join(src, "note.txt"), "utf8"), /^run \d+/);
1295
1296 // An agent's push: the run executes the agent's code, so its token is an agent's and may not push to the default branch.
1297 const agentClone = join(work, "policy-agent");
1298 git(work, ["clone", "-q", `${base}/${owner}/policy.git`, agentClone], bot);
1299 git(agentClone, ["checkout", "-q", "-b", "agent-work"], bot);
1300 writeFileSync(join(agentClone, "agent.txt"), "from the agent\n");
1301 git(agentClone, ["add", "agent.txt"], bot);
1302 git(agentClone, ["commit", "-q", "-m", "agent change"], bot);
1303 git(agentClone, ["push", "-q", "origin", "agent-work"], bot);
1304 logs = await runJobs(1);
1305 assert.match(logs.probe, /main push: refused .*agents may not push to protected or default branches/);
1306 assert.match(logs.probe, refused(".github/workflows/policy.yml"));
1307
1308 // A person opens a pull request from the branch the agent pushed: still the agent's code.
1309 // Workflows may not approve pull requests unless the repository allows it.
1310 const pr1 = await ok("POST", `/repos/${owner}/policy/pulls`, { title: "Agent work", head: "agent-work", base: "main" });
1311 logs = await runJobs(1);
1312 assert.match(logs.probe, /main push: refused .*agents may not push/);
1313 assert.match(logs.probe, /approve: 403 .*GitHub Actions is not permitted to approve pull requests/);
1314 assert.equal((await ok("GET", `/repos/${owner}/policy/pulls/${pr1.number}/reviews`)).length, 0);
1315
1316 // Allowed: the approval is recorded, but only people's approvals count toward the required ones.
1317 await ok("PUT", settingsPath, { can_approve_pull_request_reviews: true });
1318 assert.deepEqual(await ok("GET", settingsPath), { default_workflow_permissions: "read", can_approve_pull_request_reviews: true, agent_runs_use_secrets: false });
1319 await ok("PUT", `/repos/${owner}/policy/branches/main/protection`, {
1320 requirePullRequest: true,
1321 requiredApprovals: 1,
1322 dismissStaleReviews: false,
1323 requiredChecks: [],
1324 allowForcePush: false,
1325 allowDeletion: false,
1326 requireLinearHistory: false,
1327 enforceAdmins: true,
1328 agentsMayPush: false,
1329 agentsMayMerge: false,
1330 });
1331 git(src, ["checkout", "-q", "-b", "feature"]);
1332 writeFileSync(join(src, "feature.txt"), "a person's change\n");
1333 git(src, ["add", "feature.txt"]);
1334 git(src, ["commit", "-q", "-m", "feature"]);
1335 git(src, ["push", "-q", "origin", "feature"]);
1336 const pr2 = await ok("POST", `/repos/${owner}/policy/pulls`, { title: "Feature", head: "feature", base: "main" });
1337 logs = await runJobs(1);
1338 assert.match(logs.probe, /main push: refused .*pull request/);
1339 assert.match(logs.probe, /approve: 20[01] /);
1340 const reviews = await ok("GET", `/repos/${owner}/policy/pulls/${pr2.number}/reviews`);
1341 assert.deepEqual(reviews.map((r) => r.state), ["APPROVED"]);
1342 const m = await ok("GET", `/repos/${owner}/policy/pulls/${pr2.number}/merge`);
1343 assert.equal(m.mergeable, false, JSON.stringify(m));
1344 assert.equal(m.approvals, 0, JSON.stringify(m));
1345 assert.match(JSON.stringify(m.blockers), /needs 1 more approving review/);
1346});
1347
1348const SCOPES_WORKFLOW = `name: Scopes
1349on:
1350 push:
1351 branches: [main, a, b]
1352 pull_request:
1353jobs:
1354 c:
1355 runs-on: [self-hosted, linux]
1356 steps:
1357 - uses: actions/cache@v4
1358 with: { path: built, key: "b-\${{ github.run_id }}", restore-keys: "b-" }
1359 - uses: actions/cache@v4
1360 env: { DIFFINERY_BUILTINS: "false" }
1361 with: { path: real, key: "r-\${{ github.run_id }}", restore-keys: "r-" }
1362 - run: |
1363 echo "restored built=[$(cat built/from 2>/dev/null)] real=[$(cat real/from 2>/dev/null)]"
1364 mkdir -p built real && echo "$GITHUB_REF" > built/from && echo "$GITHUB_REF" > real/from
1365 - if: github.ref == 'refs/heads/main'
1366 uses: actions/upload-artifact@v4
1367 with: { name: "builtin-\${{ github.run_id }}", path: built/from, retention-days: 1 }
1368 - if: github.ref == 'refs/heads/main'
1369 uses: actions/upload-artifact@v4
1370 env: { DIFFINERY_BUILTINS: "false" }
1371 with: { name: "real-\${{ github.run_id }}", path: built/from, retention-days: 3 }
1372 - if: github.ref == 'refs/heads/main'
1373 uses: actions/upload-artifact@v4
1374 with: { name: "capped-\${{ github.run_id }}", path: built/from, retention-days: 400 }
1375`;
1376
1377test("caches are scoped to branches and pull requests; artifacts keep their retention-days", { timeout: 900_000 }, async () => {
1378 const owner = (await ok("GET", "/user")).login;
1379 await ok("POST", "/user/repos", { name: "scopes" });
1380 const src = join(work, "scopes");
1381 mkdirSync(join(src, ".github/workflows"), { recursive: true });
1382 writeFileSync(join(src, ".github/workflows/scopes.yml"), SCOPES_WORKFLOW);
1383 writeFileSync(join(src, "README.md"), "# scopes\n");
1384 git(src, ["init", "-q", "-b", "main"]);
1385 git(src, ["add", "-A"]);
1386 git(src, ["commit", "-q", "-m", "scopes"]);
1387 git(src, ["remote", "add", "origin", `${base}/${owner}/scopes.git`]);
1388 /** Runs the job a push or pull request started; returns what its caches restored. */
1389 const restored = async () => {
1390 const { claim } = await runOneJob(owner, "scopes", { timeoutMs: 300_000 });
1391 const log = await (await fetch(`${base}/api/v3/repos/${owner}/scopes/actions/jobs/${claim.job_id}/logs`, { headers: { authorization: `Bearer ${token}` } })).text();
1392 const m = /^\S+ restored built=\[(.*?)\] real=\[(.*?)\]$/m.exec(log);
1393 assert.ok(m, log);
1394 return { builtin: m[1], real: m[2] };
1395 };
1396 const branch = (name, from, file) => {
1397 git(src, ["checkout", "-q", "-b", name, from]);
1398 if (file) {
1399 writeFileSync(join(src, file), `${name}\n`);
1400 git(src, ["add", file]);
1401 git(src, ["commit", "-q", "-m", name]);
1402 }
1403 git(src, ["push", "-q", "origin", name]);
1404 };
1405
1406 // The default branch starts empty and saves its own entries.
1407 git(src, ["push", "-q", "origin", "main"]);
1408 assert.deepEqual(await restored(), { builtin: "", real: "" });
1409 // A branch falls back to the default branch's caches...
1410 branch("a", "main", "a.txt");
1411 assert.deepEqual(await restored(), { builtin: "refs/heads/main", real: "refs/heads/main" });
1412 // ...but never sees another branch's, though a's are newer and match the restore key.
1413 branch("b", "main", "b.txt");
1414 assert.deepEqual(await restored(), { builtin: "refs/heads/main", real: "refs/heads/main" });
1415 // A pull request reads its base branch's caches.
1416 branch("c", "a", "c.txt");
1417 await ok("POST", `/repos/${owner}/scopes/pulls`, { title: "c into a", head: "c", base: "a" });
1418 assert.deepEqual(await restored(), { builtin: "refs/heads/a", real: "refs/heads/a" });
1419 // Another pull request doesn't see the first one's (saved under refs/pull/<n>/merge).
1420 branch("d", "main", "d.txt");
1421 await ok("POST", `/repos/${owner}/scopes/pulls`, { title: "d into main", head: "d", base: "main" });
1422 assert.deepEqual(await restored(), { builtin: "refs/heads/main", real: "refs/heads/main" });
1423 const caches = await ok("GET", `/repos/${owner}/scopes/actions/caches?per_page=100`);
1424 assert.deepEqual([...new Set(caches.actions_caches.map((c) => c.ref))].sort(), ["refs/heads/a", "refs/heads/b", "refs/heads/main", "refs/pull/1/merge", "refs/pull/2/merge"]);
1425 // A page at a time, with GitHub's Link header.
1426 const page = await fetch(`${base}/api/v3/repos/${owner}/scopes/actions/caches?per_page=2`, { headers: { authorization: `Bearer ${token}` } });
1427 assert.equal((await page.json()).actions_caches.length, 2);
1428 assert.match(page.headers.get("link") ?? "", /[?&]page=2>; rel="next".*rel="last"/);
1429
1430 // retention-days (the built-in and the real upload-artifact), capped at 90 days.
1431 const days = (iso) => Math.round((Date.parse(iso) - Date.now()) / 86_400_000);
1432 const artifacts = (await ok("GET", `/repos/${owner}/scopes/actions/runs/1/artifacts`)).artifacts;
1433 const byName = Object.fromEntries(artifacts.map((a) => [a.name.replace(/-\d+$/, ""), a]));
1434 assert.equal(days(byName.builtin.expires_at), 1, JSON.stringify(byName.builtin));
1435 assert.equal(days(byName.real.expires_at), 3, JSON.stringify(byName.real));
1436 assert.equal(days(byName.capped.expires_at), 90, JSON.stringify(byName.capped));
1437 assert.ok(artifacts.every((a) => a.expired === false));
1438});
1439
1440test("an older runner's cache API is scoped the same way", async () => {
1441 const owner = (await ok("GET", "/user")).login;
1442 await ok("POST", "/user/repos", { name: "legacy-cache" });
1443 const src = join(work, "legacy-cache");
1444 mkdirSync(join(src, ".github/workflows"), { recursive: true });
1445 writeFileSync(join(src, ".github/workflows/w.yml"), "on:\n push:\n branches: [main, a, b]\njobs:\n j:\n runs-on: [self-hosted, linux]\n steps: [{ run: echo }]\n");
1446 git(src, ["init", "-q", "-b", "main"]);
1447 git(src, ["add", "-A"]);
1448 git(src, ["commit", "-q", "-m", "legacy"]);
1449 git(src, ["remote", "add", "origin", `${base}/${owner}/legacy-cache.git`]);
1450
1451 /** Claims the job a push started and starts it, as an older runner would, without running steps. */
1452 const startJob = async () => {
1453 const claim = await until("a job to claim", async () => {
1454 const r = await runnerClaim(`/repos/${owner}/legacy-cache`, ["linux"]);
1455 return r.status === 200 ? r.json : null;
1456 });
1457 const h = { authorization: `Bearer ${claim.token}` };
1458 const at = `${base}/runner/jobs/${claim.job_id}`;
1459 assert.equal((await fetch(at, { headers: h })).status, 200);
1460 return {
1461 put: async (key, body) => (await fetch(`${at}/cache/${encodeURIComponent(key)}`, { method: "PUT", headers: { ...h, "content-length": String(body.length) }, body })).status,
1462 lookup: async (key, restore = "") => {
1463 const r = await fetch(`${at}/cache?key=${encodeURIComponent(key)}&restore=${encodeURIComponent(restore)}`, { headers: h });
1464 if (r.status !== 200) return { status: r.status };
1465 const hit = await r.json();
1466 const blob = await fetch(hit.url, { headers: h });
1467 return { key: hit.key, content: blob.status === 200 ? await blob.text() : blob.status };
1468 },
1469 blob: async (stored) => (await fetch(`${at}/cache/blob/${encodeURIComponent(stored)}`, { headers: h })).status,
1470 done: async () => assert.equal((await fetch(`${at}/complete`, { method: "POST", headers: { ...h, "content-type": "application/json" }, body: JSON.stringify({ conclusion: "success", outputs: {} }) })).status, 200),
1471 };
1472 };
1473
1474 const branch = (name) => {
1475 git(src, ["checkout", "-q", "-b", name, "main"]);
1476 writeFileSync(join(src, `${name}.txt`), `${name}\n`);
1477 git(src, ["add", "-A"]);
1478 git(src, ["commit", "-q", "-m", name]);
1479 git(src, ["push", "-q", "origin", name]);
1480 };
1481
1482 git(src, ["push", "-q", "origin", "main"]);
1483 let job = await startJob();
1484 assert.equal(await job.put("lk-main", "from main"), 200);
1485 await job.done();
1486
1487 branch("a");
1488 job = await startJob();
1489 assert.deepEqual(await job.lookup("lk-a", "lk-"), { key: "lk-main", content: "from main" });
1490 assert.equal(await job.put("lk-a", "from a"), 200);
1491 assert.deepEqual(await job.lookup("lk-a"), { key: "lk-a", content: "from a" });
1492 await job.done();
1493
1494 branch("b");
1495 job = await startJob();
1496 assert.deepEqual(await job.lookup("lk-a"), { status: 404 });
1497 assert.deepEqual(await job.lookup("lk-x", "lk-"), { key: "lk-main", content: "from main" });
1498 // a's entry can't be fetched directly either
1499 assert.equal(await job.blob("refs/heads/a\nlk-a"), 404);
1500 assert.equal(await job.blob("lk-a"), 404);
1501 await job.done();
1502});
1503
1504test("an older runner's artifact API needs the job's own token", async () => {
1505 const owner = (await ok("GET", "/user")).login;
1506 await ok("POST", "/user/repos", { name: "legacy-artifacts" });
1507 const src = join(work, "legacy-artifacts");
1508 mkdirSync(join(src, ".github/workflows"), { recursive: true });
1509 writeFileSync(join(src, ".github/workflows/w.yml"), "on: push\njobs:\n j:\n runs-on: [self-hosted, linux]\n steps: [{ run: echo }]\n");
1510 git(src, ["init", "-q", "-b", "main"]);
1511 git(src, ["add", "-A"]);
1512 git(src, ["commit", "-q", "-m", "legacy"]);
1513 git(src, ["remote", "add", "origin", `${base}/${owner}/legacy-artifacts.git`]);
1514 git(src, ["push", "-q", "origin", "main"]);
1515 const claim = await until("a job to claim", async () => {
1516 const r = await runnerClaim(`/repos/${owner}/legacy-artifacts`, ["linux"]);
1517 return r.status === 200 ? r.json : null;
1518 });
1519 const at = `${base}/runner/jobs/${claim.job_id}/artifacts/out`;
1520 const real = { authorization: `Bearer ${claim.token}` };
1521 // Same shape (djt_<repo>_<job>_...) as the real token, but not it.
1522 const forged = { authorization: `Bearer ${claim.token.split("_").slice(0, 3).join("_")}_${"0".repeat(48)}` };
1523 assert.equal((await fetch(`${base}/runner/jobs/${claim.job_id}`, { headers: real })).status, 200);
1524 const put = async (h, body) => (await fetch(at, { method: "PUT", headers: { ...h, "content-length": String(body.length) }, body })).status;
1525 const get = async (h) => {
1526 const r = await fetch(at, { headers: h });
1527 return r.status === 200 ? await r.text() : r.status;
1528 };
1529 assert.equal(await put(real, "real bytes"), 200);
1530 assert.equal(await put(forged, "forged bytes"), 401);
1531 assert.equal(await get(forged), 401);
1532 assert.equal(await get({}), 401);
1533 // The forged upload never reached storage.
1534 assert.equal(await get(real), "real bytes");
1535 assert.equal((await fetch(`${base}/runner/jobs/${claim.job_id}/complete`, { method: "POST", headers: { ...real, "content-type": "application/json" }, body: JSON.stringify({ conclusion: "success", outputs: {} }) })).status, 200);
1536 // A finished job's token no longer reads or writes.
1537 assert.equal(await get(real), 401);
1538});
1539
1540test("an older runner's artifacts are listed, downloaded and deleted through the REST API", async () => {
1541 const owner = (await ok("GET", "/user")).login;
1542 await ok("POST", "/user/repos", { name: "legacy-rest" });
1543 const src = join(work, "legacy-rest");
1544 mkdirSync(join(src, ".github/workflows"), { recursive: true });
1545 writeFileSync(join(src, ".github/workflows/w.yml"), "on: push\njobs:\n j:\n runs-on: [self-hosted, linux]\n steps: [{ run: echo }]\n");
1546 git(src, ["init", "-q", "-b", "main"]);
1547 git(src, ["add", "-A"]);
1548 git(src, ["commit", "-q", "-m", "legacy"]);
1549 git(src, ["remote", "add", "origin", `${base}/${owner}/legacy-rest.git`]);
1550 git(src, ["push", "-q", "origin", "main"]);
1551 const claim = await until("a job to claim", async () => {
1552 const r = await runnerClaim(`/repos/${owner}/legacy-rest`, ["linux"]);
1553 return r.status === 200 ? r.json : null;
1554 });
1555 const h = { authorization: `Bearer ${claim.token}` };
1556 const at = `${base}/runner/jobs/${claim.job_id}`;
1557 assert.equal((await fetch(at, { headers: h })).status, 200);
1558 for (const name of ["one", "two", "three"]) {
1559 assert.equal((await fetch(`${at}/artifacts/${name}`, { method: "PUT", headers: { ...h, "content-length": String(name.length) }, body: name })).status, 200);
1560 }
1561 const rest = (path, init = {}) => fetch(`${base}/api/v3/repos/${owner}/legacy-rest${path}`, { ...init, headers: { authorization: `Bearer ${token}` } });
1562
1563 // Listed with numeric ids, across the repository and for the run, a page at a time.
1564 let r = await rest("/actions/artifacts?per_page=2");
1565 let body = await r.json();
1566 assert.equal(body.total_count, 3, JSON.stringify(body));
1567 assert.equal(body.artifacts.length, 2);
1568 assert.ok(body.artifacts.every((a) => Number.isSafeInteger(a.id) && a.expired === false), JSON.stringify(body));
1569 assert.match(r.headers.get("link") ?? "", /[?&]page=2>; rel="next"/);
1570 const runId = body.artifacts[0].workflow_run.id;
1571 r = await rest(`/actions/runs/${runId}/artifacts?per_page=2&page=2`);
1572 body = await r.json();
1573 assert.equal(body.total_count, 3);
1574 assert.equal(body.artifacts.length, 1);
1575 assert.match(r.headers.get("link") ?? "", /rel="prev"/);
1576 assert.doesNotMatch(r.headers.get("link") ?? "", /rel="next"/);
1577 const two = (await (await rest(`/actions/runs/${runId}/artifacts?name=two`)).json()).artifacts[0];
1578 assert.equal((await (await rest(`/actions/artifacts/${two.id}`)).json()).name, "two");
1579
1580 // The download is the tarball the runner uploaded.
1581 const zip = await rest(`/actions/artifacts/${two.id}/zip`, { redirect: "manual" });
1582 assert.equal(zip.status, 302);
1583 const blob = await fetch(zip.headers.get("location"));
1584 assert.equal(blob.status, 200);
1585 assert.equal(blob.headers.get("content-type"), "application/gzip");
1586 assert.match(blob.headers.get("content-disposition") ?? "", /two\.tar\.gz/);
1587 assert.equal(await blob.text(), "two");
1588
1589 // Deleting it removes it for the runner too.
1590 assert.equal((await rest(`/actions/artifacts/${two.id}`, { method: "DELETE" })).status, 204);
1591 assert.equal((await rest(`/actions/artifacts/${two.id}`)).status, 404);
1592 assert.equal((await fetch(`${at}/artifacts/two`, { headers: h })).status, 404);
1593 assert.equal(await (await fetch(`${at}/artifacts/one`, { headers: h })).text(), "one");
1594 assert.equal((await (await rest("/actions/artifacts")).json()).total_count, 2);
1595 assert.equal((await fetch(`${at}/complete`, { method: "POST", headers: { ...h, "content-type": "application/json" }, body: JSON.stringify({ conclusion: "success", outputs: {} }) })).status, 200);
1596});
1597
1598const hasDocker = spawnSync("docker", ["info"], { stdio: "ignore", timeout: 15_000 }).status === 0;
1599
1600test("containers: a job container and service containers on a self-hosted runner", { skip: !hasDocker && "Docker is not available" }, async () => {
1601 const owner = (await ok("GET", "/user")).login;
1602 await ok("POST", "/user/repos", { name: "boxes" });
1603 const src = join(work, "boxes");
1604 mkdirSync(join(src, ".github/workflows"), { recursive: true });
1605 // Docker Hub rate-limits anonymous pulls; mirror.gcr.io serves the same official images.
1606 writeFileSync(
1607 join(src, ".github/workflows/ci.yml"),
1608 `on: push
1609jobs:
1610 boxed:
1611 runs-on: [self-hosted, linux]
1612 container:
1613 image: mirror.gcr.io/library/debian:\${{ github.event_name == 'push' && 'bookworm-slim' || 'nope' }}
1614 services:
1615 cache:
1616 image: mirror.gcr.io/library/redis:7-alpine
1617 options: --health-cmd "redis-cli ping" --health-interval 1s --health-retries 30
1618 steps:
1619 - run: |
1620 grep -q bookworm /etc/os-release && echo "inside debian"
1621 exec 3<>/dev/tcp/cache/6379
1622 printf 'PING\\r\\n' >&3
1623 read -r line <&3
1624 echo "cache answered \${line%$'\\r'}"
1625`,
1626 );
1627 git(src, ["init", "-q", "-b", "main"]);
1628 git(src, ["add", "."]);
1629 git(src, ["commit", "-q", "-m", "containers"]);
1630 git(src, ["remote", "add", "origin", `${base}/${owner}/boxes.git`]);
1631 git(src, ["push", "-q", "origin", "main"]);
1632
1633 const run = await until("boxes run", async () => (await ok("GET", `/repos/${owner}/boxes/actions/runs`)).workflow_runs[0]);
1634 const boxed = await runOneJob(owner, "boxes");
1635 assert.equal(boxed.claim.name, "boxed");
1636 const log = await (await fetch(`${base}/api/v3/repos/${owner}/boxes/actions/jobs/${boxed.claim.job_id}/logs`, { headers: { authorization: `Bearer ${token}` } })).text();
1637 assert.match(log, /inside debian/);
1638 assert.match(log, /cache answered \+PONG/);
1639 const done = await until("boxes run to complete", async () => {
1640 const r = await ok("GET", `/repos/${owner}/boxes/actions/runs/${run.id}`);
1641 return r.status === "completed" ? r : null;
1642 });
1643 assert.equal(done.conclusion, "success");
1644});
1645
1646// ---------------------------------------------------------------- the official actions, unmodified
1647
1648// No workflow-level permissions: jobs get the repository default (write), like GitHub's permissive default.
1649const TOOLKIT_WORKFLOW = `name: Toolkit
1650on: push
1651jobs:
1652 produce:
1653 runs-on: [self-hosted, linux]
1654 steps:
1655 - uses: actions/checkout@v4
1656 with: { lfs: true, submodules: true, persist-credentials: false }
1657 - name: LFS, submodules, no persisted credentials
1658 run: |
1659 cat big.bin lib/lib.txt
1660 git config --get-regexp 'extraheader' || echo "no persisted credentials"
1661 - uses: actions/checkout@v4
1662 with: { path: sparse, sparse-checkout: docs }
1663 - run: echo "sparse=$(ls sparse | tr '\\n' ' ')"
1664 - id: real-cache
1665 uses: actions/cache@v4
1666 env: { DIFFINERY_BUILTINS: "false" }
1667 with: { path: deps, key: "deps-\${{ hashFiles('lock.txt') }}" }
1668 - if: steps.real-cache.outputs.cache-hit != 'true'
1669 run: mkdir -p deps && echo "saved by run \${{ github.run_id }}" > deps/marker
1670 - run: echo "real-hit=\${{ steps.real-cache.outputs.cache-hit }} $(cat deps/marker)"
1671 - id: builtin-cache
1672 uses: actions/cache/restore@v4
1673 with: { path: deps, key: "deps-\${{ hashFiles('lock.txt') }}", lookup-only: true }
1674 - id: v3-cache
1675 uses: actions/cache/restore@v3
1676 env: { DIFFINERY_BUILTINS: "false" }
1677 with: { path: deps, key: "deps-\${{ hashFiles('lock.txt') }}", lookup-only: true }
1678 - run: echo "builtin-hit=\${{ steps.builtin-cache.outputs.cache-hit }} v3-hit=\${{ steps.v3-cache.outputs.cache-hit }}"
1679 - run: mkdir -p dist/sub && echo one > dist/one.txt && echo two > dist/sub/two.txt && echo hidden > dist/.hidden
1680 - id: up-real
1681 uses: actions/upload-artifact@v4
1682 env: { DIFFINERY_BUILTINS: "false" }
1683 with: { name: dist-real, path: dist/, include-hidden-files: true, retention-days: 3 }
1684 - id: up-builtin
1685 uses: actions/upload-artifact@v4
1686 with: { name: dist-builtin, path: dist/, compression-level: 0 }
1687 - run: echo "ids=\${{ steps.up-real.outputs.artifact-id }},\${{ steps.up-builtin.outputs.artifact-id }} url=\${{ steps.up-real.outputs.artifact-url }}"
1688 consume:
1689 needs: produce
1690 runs-on: [self-hosted, linux]
1691 steps:
1692 - uses: actions/download-artifact@v4
1693 env: { DIFFINERY_BUILTINS: "false" }
1694 with: { path: all }
1695 - uses: actions/download-artifact@v4
1696 with: { pattern: dist-*, path: merged, merge-multiple: true }
1697 - uses: actions/download-artifact@v4
1698 env: { DIFFINERY_BUILTINS: "false" }
1699 with: { name: dist-builtin, path: one }
1700 - run: find all merged one -type f | LC_ALL=C sort | tr '\\n' ' '
1701 - uses: actions/checkout@v4
1702 with: { path: src }
1703 - id: prev
1704 run: echo "id=$(cat src/prev-run.txt 2>/dev/null)" >> "$GITHUB_OUTPUT"
1705 - if: steps.prev.outputs.id != ''
1706 uses: actions/download-artifact@v4
1707 env: { DIFFINERY_BUILTINS: "false" }
1708 with: { name: dist-real, path: prev-real, run-id: "\${{ steps.prev.outputs.id }}", github-token: "\${{ github.token }}", repository: "\${{ github.repository }}" }
1709 - if: steps.prev.outputs.id != ''
1710 uses: actions/download-artifact@v4
1711 with: { pattern: "dist-*", path: prev-builtin, run-id: "\${{ steps.prev.outputs.id }}", github-token: "\${{ github.token }}" }
1712 - if: steps.prev.outputs.id != ''
1713 run: echo "previous run $(cat prev-real/sub/two.txt) $(find prev-builtin -type f | LC_ALL=C sort | tr '\\n' ' ')"
1714 script:
1715 runs-on: [self-hosted, linux]
1716 steps:
1717 - id: gs
1718 uses: actions/github-script@v7
1719 with:
1720 result-encoding: string
1721 script: |
1722 const { owner, repo } = context.repo;
1723 const label = \`from-run-\${context.runId}\`;
1724 await github.rest.issues.createLabel({ owner, repo, name: label, color: "ff0000" });
1725 const { data: issue } = await github.rest.issues.create({ owner, repo, title: \`Opened by run \${context.runId}\`, body: "hello", labels: [label] });
1726 await github.rest.issues.createComment({ owner, repo, issue_number: issue.number, body: "commented by github-script" });
1727 const { data: comments } = await github.rest.issues.listComments({ owner, repo, issue_number: issue.number });
1728 const { data: got } = await github.rest.issues.get({ owner, repo, issue_number: issue.number });
1729 const { data: pulls } = await github.rest.pulls.list({ owner, repo, state: "all" });
1730 await github.rest.repos.createCommitStatus({ owner, repo, sha: context.sha, state: "success", context: "github-script", description: "set with the default GITHUB_TOKEN" });
1731 return \`issue=\${issue.number} labels=\${got.labels.map((l) => l.name)} comments=\${comments.length} pulls=\${pulls.length} event=\${context.eventName} repo=\${context.payload.repository.full_name} sender=\${context.payload.sender.login}\`;
1732 - run: echo "script says $RESULT"
1733 env: { RESULT: "\${{ steps.gs.outputs.result }}" }
1734 restricted:
1735 runs-on: [self-hosted, linux]
1736 permissions: { contents: read }
1737 steps:
1738 - id: gs
1739 uses: actions/github-script@v7
1740 with:
1741 result-encoding: string
1742 script: |
1743 const { owner, repo } = context.repo;
1744 const { data: meta } = await github.rest.repos.get({ owner, repo });
1745 try {
1746 await github.rest.issues.create({ owner, repo, title: "must not be created" });
1747 return "issue write allowed";
1748 } catch (e) {
1749 return \`repo=\${meta.name} issue write -> \${e.status}: \${e.message}\`;
1750 }
1751 - run: echo "restricted says $RESULT"
1752 env: { RESULT: "\${{ steps.gs.outputs.result }}" }
1753 node:
1754 runs-on: [self-hosted, linux]
1755 steps:
1756 - uses: actions/checkout@v4
1757 - id: node
1758 uses: actions/setup-node@v4
1759 with: { node-version: 20, cache: npm }
1760 - run: npm ci --no-audit --no-fund && echo "node=$(node --version) npm-cache-hit=\${{ steps.node.outputs.cache-hit }}"
1761 java:
1762 runs-on: [self-hosted, linux]
1763 steps:
1764 - uses: actions/checkout@v4
1765 - id: java
1766 uses: actions/setup-java@v4
1767 with: { distribution: oracle, java-version: "21", cache: maven }
1768 - run: |
1769 mkdir -p ~/.m2/repository/e2e && echo "run \${{ github.run_id }}" > ~/.m2/repository/e2e/marker
1770 echo "java=$(java -version 2>&1 | grep version) maven-cache-hit=\${{ steps.java.outputs.cache-hit }} $(cat ~/.m2/repository/e2e/marker)"
1771`;
1772
1773/** Runs every job of `run` with the real agent; returns their logs by job name. */
1774async function runToolkit(owner, run) {
1775 const home = join(work, "toolkit-home");
1776 const logs = {};
1777 for (let i = 0; i < 6; i++) {
1778 const job = await runOneJob(owner, "toolkit", {
1779 timeoutMs: 420_000,
1780 envFor: (claim) => {
1781 // A fresh HOME per job (at the same path, as on hosted runners): caches must come from the cache service.
1782 rmSync(home, { recursive: true, force: true });
1783 mkdirSync(home, { recursive: true });
1784 return {
1785 ...(process.env.E2E_RUNNER_IMAGE ? {} : { HOME: home, RUNNER_TOOL_CACHE: join(work, "toolcache") }),
1786 // The node job runs every action for real, checkout and setup-node included.
1787 ...(claim.name === "node" ? { DIFFINERY_DISABLE_BUILTINS: "1" } : {}),
1788 };
1789 },
1790 });
1791 // Without the timestamps, so assertions can span lines.
1792 const raw = await (await fetch(`${base}/api/v3/repos/${owner}/toolkit/actions/jobs/${job.claim.job_id}/logs`, { headers: { authorization: `Bearer ${token}` } })).text();
1793 logs[job.claim.name] = raw.replace(/^\S+Z /gm, "");
1794 // Kept with E2E_KEEP=1 for debugging.
1795 mkdirSync(join(work, "toolkit-logs"), { recursive: true });
1796 writeFileSync(join(work, "toolkit-logs", `run${run.run_number}-${job.claim.name}.log`), `${logs[job.claim.name]}\n--- agent ---\n${job.out}`);
1797 }
1798 const done = await until("toolkit run to complete", async () => {
1799 const r = await ok("GET", `/repos/${owner}/toolkit/actions/runs/${run.id}`);
1800 return r.status === "completed" ? r : null;
1801 });
1802 assert.equal(done.conclusion, "success", JSON.stringify(logs, null, 2).slice(-8000));
1803 return logs;
1804}
1805
1806const toolkit = {};
1807
1808test("official actions: checkout, cache, artifacts, github-script and setup-* run unmodified", { timeout: 1_200_000 }, async () => {
1809 const owner = (await ok("GET", "/user")).login;
1810 toolkit.owner = owner;
1811 // A submodule repository, then the main one (LFS object, submodule, sparse-checkout target).
1812 // Public: like GITHUB_TOKEN, the job token reads only its own repository and public ones.
1813 await ok("POST", "/user/repos", { name: "toolkit-lib", visibility: "public" });
1814 const lib = join(work, "toolkit-lib");
1815 mkdirSync(lib, { recursive: true });
1816 writeFileSync(join(lib, "lib.txt"), "from the submodule\n");
1817 git(lib, ["init", "-q", "-b", "main"]);
1818 git(lib, ["add", "."]);
1819 git(lib, ["commit", "-q", "-m", "lib"]);
1820 git(lib, ["remote", "add", "origin", `${base}/${owner}/toolkit-lib.git`]);
1821 git(lib, ["push", "-q", "origin", "main"]);
1822 const libSha = git(lib, ["rev-parse", "HEAD"]).trim();
1823
1824 await ok("POST", "/user/repos", { name: "toolkit" });
1825 // Jobs without permissions: write with the default token (the setting older repositories keep).
1826 await ok("PUT", `/repos/${owner}/toolkit/actions/permissions/workflow`, { default_workflow_permissions: "write" });
1827 const src = join(work, "toolkit");
1828 toolkit.src = src;
1829 mkdirSync(join(src, ".github/workflows"), { recursive: true });
1830 mkdirSync(join(src, "docs"));
1831 writeFileSync(join(src, ".github/workflows/toolkit.yml"), TOOLKIT_WORKFLOW);
1832 writeFileSync(join(src, "docs/guide.md"), "# guide\n");
1833 writeFileSync(join(src, "README.md"), "# toolkit\n");
1834 writeFileSync(join(src, "lock.txt"), "v1\n");
1835 writeFileSync(join(src, "package.json"), JSON.stringify({ name: "toolkit", version: "1.0.0", private: true }, null, 2) + "\n");
1836 writeFileSync(join(src, "package-lock.json"), JSON.stringify({ name: "toolkit", version: "1.0.0", lockfileVersion: 3, requires: true, packages: { "": { name: "toolkit", version: "1.0.0" } } }, null, 2) + "\n");
1837 writeFileSync(join(src, "pom.xml"), "<project><modelVersion>4.0.0</modelVersion><groupId>e2e</groupId><artifactId>toolkit</artifactId><version>1</version></project>\n");
1838 writeFileSync(join(src, ".gitmodules"), '[submodule "lib"]\n\tpath = lib\n\turl = ../toolkit-lib.git\n');
1839 git(src, ["init", "-q", "-b", "main"]);
1840 git(src, ["lfs", "install", "--local"]);
1841 git(src, ["lfs", "track", "*.bin"]);
1842 writeFileSync(join(src, "big.bin"), "the real LFS content\n");
1843 git(src, ["add", "-A"]);
1844 git(src, ["update-index", "--add", "--cacheinfo", `160000,${libSha},lib`]);
1845 git(src, ["commit", "-q", "-m", "toolkit"]);
1846 git(src, ["remote", "add", "origin", `${base}/${owner}/toolkit.git`]);
1847 git(src, ["push", "-q", "origin", "main"]);
1848 assert.match(git(src, ["show", "HEAD:big.bin"]), /git-lfs/, "big.bin is stored as an LFS pointer");
1849
1850 const run = await until("toolkit run", async () => (await ok("GET", `/repos/${owner}/toolkit/actions/runs`)).workflow_runs[0]);
1851 toolkit.firstRun = run;
1852 const logs = await runToolkit(owner, run);
1853
1854 // checkout: LFS content, submodule over HTTP with the job token, credentials not persisted, sparse
1855 assert.match(logs.produce, /the real LFS content\nfrom the submodule/);
1856 assert.match(logs.produce, /no persisted credentials/);
1857 assert.match(logs.produce, /sparse=README\.md big\.bin docs lib lock\.txt package-lock\.json package\.json pom\.xml /);
1858 // cache: a miss on the first run, for the real action and the built-in alike
1859 assert.match(logs.produce, /real-hit= saved by run 1\b/);
1860 assert.match(logs.produce, /builtin-hit= v3-hit=/);
1861 assert.match(logs.produce, /Cache saved with (the )?key: deps-[0-9a-f]{64}/);
1862 // artifacts: ids from both uploads, the URL points back at this server
1863 assert.match(logs.produce, new RegExp(`ids=\\d+,\\d+ url=${base}/${owner}/toolkit/actions/runs/1/artifacts/\\d+`));
1864 assert.match(
1865 logs.consume,
1866 /all\/dist-builtin\/one\.txt all\/dist-builtin\/sub\/two\.txt all\/dist-real\/\.hidden all\/dist-real\/one\.txt all\/dist-real\/sub\/two\.txt merged\/\.hidden merged\/one\.txt merged\/sub\/two\.txt one\/one\.txt one\/sub\/two\.txt/,
1867 );
1868 // github-script: REST calls with the job token
1869 assert.match(logs.script, /script says issue=1 labels=from-run-1 comments=1 pulls=0 event=push repo=[^/]+\/toolkit sender=\S+/);
1870 const issue = await ok("GET", `/repos/${owner}/toolkit/issues/1`);
1871 assert.equal(issue.title, "Opened by run 1");
1872 assert.deepEqual(issue.labels.map((l) => l.name), ["from-run-1"]);
1873 assert.equal((await ok("GET", `/repos/${owner}/toolkit/issues/1/comments`))[0].body, "commented by github-script");
1874 const statuses = await ok("GET", `/repos/${owner}/toolkit/commits/${run.head_sha}/statuses`);
1875 assert.equal(statuses.find((s) => s.context === "github-script")?.state, "success", JSON.stringify(statuses));
1876 // `permissions: { contents: read }`: reading works, issue writes are refused
1877 assert.match(logs.restricted, /restricted says repo=toolkit issue write -> 403: .*issues/);
1878 assert.equal((await ok("GET", `/repos/${owner}/toolkit/issues?state=all`)).filter((i) => i.title === "must not be created").length, 0);
1879 // setup-node (the real action, DIFFINERY_DISABLE_BUILTINS=1) and setup-java: installed, caches saved
1880 assert.match(logs.node, /node=v20\.\d+\.\d+ npm-cache-hit=false/);
1881 assert.match(logs.node, /Cache saved with (the )?key: node-cache-Linux-x64-npm-[0-9a-f]{64}/);
1882 assert.match(logs.java, /java=java version "21[^\n]* maven-cache-hit=false run 1/);
1883 assert.match(logs.java, /Cache saved with (the )?key: setup-java-Linux-x64-maven-[0-9a-f]{64}/);
1884
1885 // the REST API lists the run's artifacts and caches
1886 const artifacts = await ok("GET", `/repos/${owner}/toolkit/actions/runs/1/artifacts`);
1887 assert.deepEqual(artifacts.artifacts.map((a) => a.name).sort(), ["dist-builtin", "dist-real"]);
1888 const caches = await ok("GET", `/repos/${owner}/toolkit/actions/caches`);
1889 assert.equal(caches.total_count, 3, JSON.stringify(caches));
1890 const zip = await fetch(`${base}/api/v3/repos/${owner}/toolkit/actions/artifacts/${artifacts.artifacts[0].id}/zip`, { headers: { authorization: `Bearer ${token}` }, redirect: "manual" });
1891 assert.equal(zip.status, 302);
1892 assert.equal((await fetch(zip.headers.get("location"))).headers.get("content-type"), "application/zip");
1893});
1894
1895test("official actions: the second run hits every cache and reads the first run's artifacts", { timeout: 1_200_000 }, async () => {
1896 const { owner, src, firstRun } = toolkit;
1897 assert.ok(firstRun, "the first toolkit run must have completed");
1898 writeFileSync(join(src, "prev-run.txt"), `${firstRun.run_number}\n`);
1899 git(src, ["add", "prev-run.txt"]);
1900 git(src, ["commit", "-q", "-m", "second run"]);
1901 git(src, ["push", "-q", "origin", "main"]);
1902 const run = await until("second toolkit run", async () => (await ok("GET", `/repos/${owner}/toolkit/actions/runs`)).workflow_runs.find((r) => r.run_number === 2));
1903 const logs = await runToolkit(owner, run);
1904
1905 // The entry the real action saved restores with the real action (v4 and v3) and the built-in.
1906 assert.match(logs.produce, /real-hit=true saved by run 1\b/);
1907 assert.match(logs.produce, /builtin-hit=true v3-hit=true/);
1908 assert.match(logs.produce, /Cache hit occurred on the primary key deps-[0-9a-f]{64}, not saving cache\./);
1909 assert.match(logs.node, /npm-cache-hit=true/);
1910 assert.match(logs.java, /maven-cache-hit=true run 2/);
1911 // Artifacts of another run, through the REST API with github-token (real action and built-in).
1912 assert.match(logs.consume, /previous run two prev-builtin\/dist-builtin\/one\.txt prev-builtin\/dist-builtin\/sub\/two\.txt prev-builtin\/dist-real\/\.hidden prev-builtin\/dist-real\/one\.txt prev-builtin\/dist-real\/sub\/two\.txt/);
1913 assert.match(logs.script, /script says issue=2 labels=from-run-2 comments=1/);
1914});
1915
1916test("objects of every size: files from 0 bytes to 1.2 MB, read cold after a restart, come back intact from contents, diffs, pushes and clones", async () => {
1917 // A server of its own, restarted after the first push so nothing is in memory: reads then inflate
1918 // every object from storage, as in production.
1919 let server = await startServer("cold-sizes");
1920 try {
1921 let c = client(server);
1922 const me = await c.ok("GET", "/user");
1923 await c.ok("POST", "/user/repos", { name: "cold-sizes" });
1924 const src = join(work, "cold-sizes");
1925 mkdirSync(src, { recursive: true });
1926 await c.git(src, ["init", "-q", "-b", "main"]);
1927 // Around zlib's and the runtime's buffer steps, as text and as random base64. Workers' own zlib once
1928 // refused 41,271, 65,536 and 101,330 bytes when told the exact size (#277), which Node's zlib, and so
1929 // the unit tests, never do.
1930 const sizes = [0, 1, 1000, 16_384, 16_385, 32_769, 41_271, 49_153, 65_535, 65_536, 65_537, 98_304, 101_330, 131_073, 200_000, 524_289, 1_048_576, 1_048_577, 1_200_000];
1931 const words = "the quick brown fox jumps over a lazy dog while git packs objects into zlib streams".split(" ");
1932 const text = (n) => {
1933 let t = "";
1934 for (let i = 0; t.length < n; i++) t += words[(i * 7 + (i >> 3)) % words.length] + (i % 11 === 10 ? "\n" : " ");
1935 return Buffer.from(t.slice(0, n));
1936 };
1937 const random = (n) => Buffer.from(randomBytes(Math.ceil(n * 0.75) + 3).toString("base64").slice(0, n));
1938 const files = new Map(sizes.flatMap((n) => [[`text${n}.txt`, text(n)], [`b64-${n}.txt`, random(n)]]));
1939 for (const [name, data] of files) writeFileSync(join(src, name), data);
1940 await c.git(src, ["add", "-A"]);
1941 await c.git(src, ["commit", "-q", "-m", "every size"]);
1942 const first = (await c.git(src, ["rev-parse", "HEAD"])).trim();
1943 await c.git(src, ["-c", "http.postBuffer=1048576", "push", "-q", `${c.gitBase}/${me.login}/cold-sizes.git`, "main"]);
1944
1945 server.stop();
1946 while (await fetch(`${server.base}/healthz`).then(() => true, () => false)) await sleep(500);
1947 await sleep(1000);
1948 server = await startServer("cold-sizes", { restart: true });
1949 c = client(server);
1950
1951 // A second push changes each file by a line: git sends deltas against the objects the server has,
1952 // so taking it in reads each base cold.
1953 for (const [name, data] of files) writeFileSync(join(src, name), Buffer.concat([data, Buffer.from("\nchanged\n")]));
1954 await c.git(src, ["add", "-A"]);
1955 await c.git(src, ["commit", "-q", "-m", "every size, changed"]);
1956 await c.git(src, ["-c", "http.postBuffer=1048576", "push", "-q", `${c.gitBase}/${me.login}/cold-sizes.git`, "main"]);
1957 // The commit's diff reads both versions of each file.
1958 const commit = await c.ok("GET", `/repos/${me.login}/cold-sizes/commits/main`);
1959 assert.equal(commit.files.length, files.size);
1960 const read = async (path, accept) => {
1961 const res = await fetch(`${server.base}/api/v3${path}`, { headers: { authorization: `Bearer ${server.token}`, accept } });
1962 assert.equal(res.status, 200, `${path}: ${res.status} ${(await res.clone().text()).slice(0, 300)}`);
1963 return res;
1964 };
1965 for (const [name, data] of files) {
1966 const res = await read(`/repos/${me.login}/cold-sizes/contents/${name}?ref=${first}`, "application/vnd.github.raw");
1967 assert.ok(Buffer.from(await res.arrayBuffer()).equals(data), `${name} reads back as first pushed`);
1968 if (data.length <= 1024 * 1024) {
1969 const json = await (await read(`/repos/${me.login}/cold-sizes/contents/${name}?ref=${first}`, "application/json")).json();
1970 assert.ok(Buffer.from(json.content, "base64").equals(data), `${name} in JSON reads back as first pushed`);
1971 }
1972 }
1973 const out = join(work, "cold-sizes-clone");
1974 await c.git(work, ["clone", "-q", `${c.gitBase}/${me.login}/cold-sizes.git`, out]);
1975 await c.git(out, ["fsck", "--full", "--strict"]);
1976 assert.equal((await c.git(out, ["rev-parse", "HEAD"])).trim(), (await c.git(src, ["rev-parse", "HEAD"])).trim());
1977 } finally {
1978 server.stop();
1979 }
1980});
1981
1982test("D1 sessions: bookmarks for token clients and browsers", async () => {
1983 // Token clients get the bookmark in a header and can send it back to read their own writes.
1984 const r = await fetch(`${base}/api/v3/user`, { headers: { authorization: `Bearer ${token}` } });
1985 assert.equal(r.status, 200);
1986 const bookmark = r.headers.get("x-d1-bookmark");
1987 assert.match(bookmark ?? "", /^[0-9a-f]+(-[0-9a-f]+)+$/i);
1988 assert.equal(r.headers.get("set-cookie"), null);
1989 const again = await fetch(`${base}/api/v3/user`, { headers: { authorization: `Bearer ${token}`, "x-d1-bookmark": bookmark } });
1990 assert.equal(again.status, 200);
1991 // A junk bookmark is ignored rather than breaking the request.
1992 assert.equal((await fetch(`${base}/api/v3/user`, { headers: { authorization: `Bearer ${token}`, "x-d1-bookmark": "nope" } })).status, 200);
1993 // Anonymous page views don't get a cookie; a browser that writes (any non-GET) does.
1994 assert.equal((await fetch(`${base}/`)).headers.get("set-cookie")?.includes("__Host-dfy_d1") ?? false, false);
1995 const post = await fetch(`${base}/auth/logout`, { method: "POST", redirect: "manual", headers: { "sec-fetch-site": "same-origin" } });
1996 assert.match(post.headers.get("set-cookie") ?? "", /__Host-dfy_d1=[0-9a-f-]+; Max-Age=86400; Path=\/; HttpOnly; Secure; SameSite=Lax/);
1997});
1998
1999test("GitHub REST compatibility: Octokit against releases, statuses, git data, issues, deployments and search", async () => {
2000 const { Octokit } = await import("@octokit/rest");
2001 const gh = new Octokit({ auth: token, baseUrl: `${base}/api/v3`, userAgent: "diffinery-e2e", request: { retries: 0 } });
2002 const owner = (await gh.rest.users.getAuthenticated()).data.login;
2003 const repo = "compat";
2004 const R = { owner, repo };
2005
2006 // ------------------------------------------------------------ repository, pushed with git
2007 const created = await gh.rest.repos.createForAuthenticatedUser({ name: repo, description: "Octokit compatibility" });
2008 assert.equal(created.status, 201);
2009 assert.equal(created.data.full_name, `${owner}/${repo}`);
2010 assert.match(created.data.node_id, /\S/);
2011 assert.equal(created.data.owner.login, owner);
2012 const src = join(work, "compat");
2013 mkdirSync(join(src, "src"), { recursive: true });
2014 writeFileSync(join(src, "README.md"), "# compat\n");
2015 writeFileSync(join(src, "src/main.ts"), "export const x = 1;\n");
2016 git(src, ["init", "-q", "-b", "main"]);
2017 git(src, ["add", "-A"]);
2018 git(src, ["commit", "-q", "-m", "initial"]);
2019 git(src, ["remote", "add", "origin", `${base}/${owner}/${repo}.git`]);
2020 git(src, ["push", "-q", "origin", "main"]);
2021 const mainSha = git(src, ["rev-parse", "HEAD"]).trim();
2022
2023 const r = await gh.rest.repos.get(R);
2024 assert.equal(r.data.default_branch, "main");
2025 assert.equal(r.data.permissions.admin, true);
2026 assert.equal(r.headers["x-github-media-type"], "github.v3; format=json");
2027 const rate = await gh.rest.rateLimit.get();
2028 assert.ok(rate.data.resources.core.remaining > 0);
2029
2030 // GitHub error bodies: message and documentation_url, surfaced by Octokit's RequestError.
2031 await assert.rejects(gh.rest.repos.getContent({ ...R, path: "missing.txt" }), (e) => e.status === 404 && typeof e.response.data.message === "string" && typeof e.response.data.documentation_url === "string");
2032
2033 // ------------------------------------------------------------ contents
2034 const readme = await gh.rest.repos.getContent({ ...R, path: "README.md" });
2035 assert.equal(readme.data.type, "file");
2036 assert.equal(Buffer.from(readme.data.content, "base64").toString(), "# compat\n");
2037 const rawReadme = await gh.rest.repos.getContent({ ...R, path: "README.md", mediaType: { format: "raw" } });
2038 assert.equal(rawReadme.data, "# compat\n");
2039 const dir = await gh.rest.repos.getContent({ ...R, path: "src" });
2040 assert.deepEqual(dir.data.map((e) => e.name), ["main.ts"]);
2041 await assert.rejects(gh.rest.repos.createOrUpdateFileContents({ ...R, path: "README.md", message: "stale", content: Buffer.from("x").toString("base64"), sha: "0".repeat(40) }), (e) => e.status === 409);
2042 const put = await gh.rest.repos.createOrUpdateFileContents({ ...R, path: "README.md", message: "Update README", content: Buffer.from("# compat\n\nUpdated.\n").toString("base64"), sha: readme.data.sha, committer: { name: "Release Bot", email: "bot@example.com" } });
2043 assert.equal(put.status, 200);
2044 assert.equal(put.data.commit.committer.name, "Release Bot");
2045 const added = await gh.rest.repos.createOrUpdateFileContents({ ...R, path: "docs/guide.md", message: "Add guide", content: Buffer.from("guide\n").toString("base64") });
2046 assert.equal(added.status, 201);
2047 const readmeApi = await gh.rest.repos.getReadme(R);
2048 assert.equal(readmeApi.data.path, "README.md");
2049
2050 // ------------------------------------------------------------ git data: blob -> tree -> commit -> ref, then git sees it
2051 const headSha = (await gh.rest.git.getRef({ ...R, ref: "heads/main" })).data.object.sha;
2052 assert.equal(headSha, added.data.commit.sha);
2053 const blob = await gh.rest.git.createBlob({ ...R, content: Buffer.from("made with the git data API\n").toString("base64"), encoding: "base64" });
2054 assert.equal(blob.status, 201);
2055 assert.equal(Buffer.from((await gh.rest.git.getBlob({ ...R, file_sha: blob.data.sha })).data.content, "base64").toString(), "made with the git data API\n");
2056 const headCommit = await gh.rest.git.getCommit({ ...R, commit_sha: headSha });
2057 const tree = await gh.rest.git.createTree({ ...R, base_tree: headCommit.data.tree.sha, tree: [{ path: "gitdata/hello.txt", mode: "100644", type: "blob", sha: blob.data.sha }, { path: "inline.txt", mode: "100644", type: "blob", content: "inline\n" }] });
2058 const full = await gh.rest.git.getTree({ ...R, tree_sha: tree.data.sha, recursive: "true" });
2059 assert.ok(full.data.tree.some((e) => e.path === "gitdata/hello.txt" && e.type === "blob"));
2060 assert.ok(full.data.tree.some((e) => e.path === "src/main.ts"));
2061 const commit = await gh.rest.git.createCommit({ ...R, message: "Commit from the git data API", tree: tree.data.sha, parents: [headSha], author: { name: "Diffy", email: "diffy@example.com", date: "2024-05-06T07:08:09Z" } });
2062 assert.equal(commit.data.author.name, "Diffy");
2063 assert.deepEqual(commit.data.parents.map((p) => p.sha), [headSha]);
2064 const ref = await gh.rest.git.createRef({ ...R, ref: "refs/heads/feature", sha: commit.data.sha });
2065 assert.equal(ref.data.ref, "refs/heads/feature");
2066 assert.equal(ref.data.object.type, "commit");
2067 await assert.rejects(gh.rest.git.createRef({ ...R, ref: "refs/heads/feature", sha: commit.data.sha }), (e) => e.status === 422);
2068 const matching = await gh.rest.git.listMatchingRefs({ ...R, ref: "heads/f" });
2069 assert.deepEqual(matching.data.map((x) => x.ref), ["refs/heads/feature"]);
2070 const tag = await gh.rest.git.createTag({ ...R, tag: "v0.1.0", message: "Annotated tag", object: commit.data.sha, type: "commit", tagger: { name: "Diffy", email: "diffy@example.com", date: "2024-05-06T07:08:09Z" } });
2071 await gh.rest.git.createRef({ ...R, ref: "refs/tags/v0.1.0", sha: tag.data.sha });
2072 assert.equal((await gh.rest.git.getTag({ ...R, tag_sha: tag.data.sha })).data.object.sha, commit.data.sha);
2073 assert.equal((await gh.rest.git.getRef({ ...R, ref: "tags/v0.1.0" })).data.object.type, "tag");
2074 git(src, ["fetch", "-q", "origin", "feature", "--tags"]);
2075 assert.equal(git(src, ["show", "FETCH_HEAD:gitdata/hello.txt"]), "made with the git data API\n");
2076 assert.equal(git(src, ["cat-file", "-t", "v0.1.0"]).trim(), "tag");
2077
2078 // ------------------------------------------------------------ commit statuses count as checks, also for required checks
2079 await ok("PUT", `/repos/${owner}/${repo}/branches/main/protection`, { requirePullRequest: true, requiredChecks: ["ci/external"] });
2080 const pr = await gh.rest.pulls.create({ ...R, title: "Feature", head: "feature", base: "main", body: "Adds files" });
2081 assert.equal(pr.status, 201);
2082 const pending = await until("mergeability", async () => {
2083 const p = (await gh.rest.pulls.get({ ...R, pull_number: pr.data.number })).data;
2084 return typeof p.mergeable === "boolean" ? p : null;
2085 });
2086 assert.equal(pending.mergeable, true);
2087 assert.equal(pending.mergeable_state, "blocked");
2088 assert.equal(pending.head.sha, commit.data.sha);
2089 const st = await gh.rest.repos.createCommitStatus({ ...R, sha: commit.data.sha, state: "success", context: "ci/external", description: "External CI passed", target_url: "https://ci.example.com/build/1" });
2090 assert.equal(st.status, 201);
2091 assert.equal(st.data.creator.login, owner);
2092 await assert.rejects(gh.rest.repos.createCommitStatus({ ...R, sha: commit.data.sha, state: "great" }), (e) => e.status === 422);
2093 const combined = await gh.rest.repos.getCombinedStatusForRef({ ...R, ref: "feature" });
2094 assert.equal(combined.data.state, "success");
2095 assert.equal(combined.data.total_count, 1);
2096 assert.equal(combined.data.statuses[0].context, "ci/external");
2097 assert.equal((await gh.rest.repos.listCommitStatusesForRef({ ...R, ref: commit.data.sha })).data.length, 1);
2098 const clean = (await gh.rest.pulls.get({ ...R, pull_number: pr.data.number })).data;
2099 assert.equal(clean.mergeable_state, "clean");
2100 const prPage = await (await fetch(`${base}/${owner}/${repo}/pull/${pr.data.number}/checks`)).text();
2101 assert.match(prPage, /ci\/external/);
2102 assert.match(prPage, /https:\/\/ci\.example\.com\/build\/1/);
2103
2104 // ------------------------------------------------------------ pull request sub-resources
2105 const byHead = await gh.rest.pulls.list({ ...R, head: `${owner}:feature`, state: "open" });
2106 assert.deepEqual(byHead.data.map((p) => p.number), [pr.data.number]);
2107 assert.equal((await gh.rest.pulls.list({ ...R, base: "other" })).data.length, 0);
2108 const assoc = await gh.rest.repos.listPullRequestsAssociatedWithCommit({ ...R, commit_sha: commit.data.sha });
2109 assert.deepEqual(assoc.data.map((p) => p.number), [pr.data.number]);
2110 const rc = await gh.rest.pulls.createReviewComment({ ...R, pull_number: pr.data.number, body: "Why this file?", commit_id: commit.data.sha, path: "inline.txt", line: 1, side: "RIGHT" });
2111 assert.equal(rc.status, 201);
2112 assert.equal(rc.data.path, "inline.txt");
2113 const reply = await gh.rest.pulls.createReplyForReviewComment({ ...R, pull_number: pr.data.number, comment_id: rc.data.id, body: "For the test." });
2114 assert.equal(reply.data.in_reply_to_id, rc.data.id);
2115 // Numeric ids, like GitHub's: actions parse them with Number() and pass them back.
2116 assert.equal(typeof rc.data.id, "number");
2117 assert.equal(typeof rc.data.pull_request_review_id, "number");
2118 assert.equal((await gh.rest.pulls.listReviewComments({ ...R, pull_number: pr.data.number })).data.length, 2);
2119 await gh.rest.reactions.createForPullRequestReviewComment({ ...R, comment_id: rc.data.id, content: "eyes" });
2120 const merged = await gh.rest.pulls.merge({ ...R, pull_number: pr.data.number, merge_method: "squash" });
2121 assert.equal(merged.data.merged, true);
2122 const merges = await gh.rest.issues.listEventsForTimeline({ ...R, issue_number: pr.data.number });
2123 assert.ok(merges.data.some((e) => e.event === "merged"));
2124
2125 // ------------------------------------------------------------ releases and assets
2126 const rel = await gh.rest.repos.createRelease({ ...R, tag_name: "v1.0.0", target_commitish: "main", name: "First", generate_release_notes: true });
2127 assert.equal(rel.status, 201);
2128 assert.match(rel.data.body, /Full Changelog/);
2129 assert.match(rel.data.body, /Feature by @/);
2130 assert.equal(rel.data.author.login, owner);
2131 assert.match(rel.data.upload_url, /\/api\/uploads\/repos\/.+\/releases\/\d+\/assets\{\?name,label\}$/);
2132 assert.match(git(src, ["ls-remote", "--tags", "origin"]), /refs\/tags\/v1\.0\.0/);
2133 const bytes = Buffer.from("hello from a release asset\n");
2134 const up = await gh.rest.repos.uploadReleaseAsset({ ...R, release_id: rel.data.id, name: "hello.txt", label: "Greeting", data: bytes, url: rel.data.upload_url, headers: { "content-type": "text/plain", "content-length": bytes.length } });
2135 assert.equal(up.status, 201);
2136 assert.equal(up.data.name, "hello.txt");
2137 assert.equal(up.data.size, bytes.length);
2138 assert.equal(up.data.state, "uploaded");
2139 const bin = Buffer.from(randomBytes(70_000));
2140 const up2 = await gh.rest.repos.uploadReleaseAsset({ ...R, release_id: rel.data.id, name: "tool linux.bin", data: bin, baseUrl: `${base}/api/uploads`, headers: { "content-type": "application/octet-stream", "content-length": bin.length } });
2141 assert.equal(up2.data.name, "tool.linux.bin");
2142 await assert.rejects(gh.rest.repos.uploadReleaseAsset({ ...R, release_id: rel.data.id, name: "hello.txt", data: bytes, url: rel.data.upload_url, headers: { "content-type": "text/plain", "content-length": bytes.length } }), (e) => e.status === 422);
2143 const viaApi = await gh.rest.repos.getReleaseAsset({ ...R, asset_id: up2.data.id, headers: { accept: "application/octet-stream" } });
2144 assert.deepEqual(Buffer.from(viaApi.data), bin);
2145 const browser = await fetch(up.data.browser_download_url);
2146 assert.equal(browser.status, 200);
2147 assert.equal(await browser.text(), bytes.toString());
2148 assert.match(browser.headers.get("content-disposition") ?? "", /attachment/);
2149 assert.equal((await gh.rest.repos.getReleaseAsset({ ...R, asset_id: up.data.id })).data.download_count, 1);
2150 assert.deepEqual((await gh.rest.repos.listReleaseAssets({ ...R, release_id: rel.data.id })).data.map((a) => a.name), ["hello.txt", "tool.linux.bin"]);
2151 assert.equal((await gh.rest.repos.updateReleaseAsset({ ...R, asset_id: up.data.id, label: "Hello" })).data.label, "Hello");
2152 assert.equal((await gh.rest.repos.getLatestRelease(R)).data.id, rel.data.id);
2153 assert.equal((await gh.rest.repos.getReleaseByTag({ ...R, tag: "v1.0.0" })).data.assets.length, 2);
2154 const notes = await gh.rest.repos.generateReleaseNotes({ ...R, tag_name: "v1.1.0", previous_tag_name: "v1.0.0" });
2155 assert.match(notes.data.body, /compare\/v1\.0\.0\.\.\.v1\.1\.0/);
2156 await gh.rest.reactions.createForRelease({ ...R, release_id: rel.data.id, content: "rocket" });
2157 assert.equal((await gh.rest.repos.getRelease({ ...R, release_id: rel.data.id })).data.reactions.rocket, 1);
2158
2159 // Drafts are for writers only; a read-only token sees neither the draft nor its tag lookup.
2160 const draft = await gh.rest.repos.createRelease({ ...R, tag_name: "v2.0.0-rc.1", name: "Next", draft: true, prerelease: true });
2161 assert.equal(draft.data.draft, true);
2162 const reader = await ok("POST", "/diffinery/tokens", { name: "reader", scopes: ["read"] }, null);
2163 const ro = new Octokit({ auth: reader.token, baseUrl: `${base}/api/v3`, request: { retries: 0 } });
2164 assert.deepEqual((await ro.rest.repos.listReleases(R)).data.map((x) => x.tag_name), ["v1.0.0"]);
2165 await assert.rejects(ro.rest.repos.getRelease({ ...R, release_id: draft.data.id }), (e) => e.status === 404);
2166 await assert.rejects(ro.rest.repos.createRelease({ ...R, tag_name: "v9" }), (e) => e.status === 403 || e.status === 404);
2167 const published = await gh.rest.repos.updateRelease({ ...R, release_id: draft.data.id, draft: false, make_latest: "false" });
2168 assert.equal(published.data.draft, false);
2169 assert.equal((await gh.rest.repos.getLatestRelease(R)).data.tag_name, "v1.0.0");
2170 await gh.rest.repos.deleteReleaseAsset({ ...R, asset_id: up2.data.id });
2171 assert.equal((await fetch(`${base}/${owner}/${repo}/releases/download/v1.0.0/tool.linux.bin`)).status, 404);
2172 await gh.rest.repos.deleteRelease({ ...R, release_id: published.data.id });
2173 await assert.rejects(gh.rest.repos.getReleaseByTag({ ...R, tag: "v2.0.0-rc.1" }), (e) => e.status === 404);
2174
2175 // Archives
2176 const zipball = await gh.rest.repos.downloadZipballArchive({ ...R, ref: "v1.0.0" });
2177 assert.equal(Buffer.from(zipball.data).subarray(0, 2).toString(), "PK");
2178 const tarball = await gh.rest.repos.downloadTarballArchive({ ...R, ref: "main" });
2179 assert.deepEqual([...Buffer.from(tarball.data).subarray(0, 2)], [0x1f, 0x8b]);
2180 const tgz = join(work, "compat.tar.gz");
2181 writeFileSync(tgz, Buffer.from(tarball.data));
2182 assert.match(execFileSync("tar", ["tzf", tgz], { encoding: "utf8" }), /\/gitdata\/hello\.txt/);
2183
2184 // The web UI: releases list, the release page and the form (CSRF, Kumo controls, multipart upload).
2185 const list = await (await fetch(`${base}/${owner}/${repo}/releases`)).text();
2186 assert.match(list, /First/);
2187 assert.match(list, /hello\.txt/);
2188 const form = await fetch(`${base}/${owner}/${repo}/releases/new`);
2189 const html = await form.text();
2190 assert.doesNotMatch(html, /<select|type="checkbox"|type="radio"/);
2191 const csrf = /name="_csrf" value="([^"]+)"/.exec(html)?.[1];
2192 const cookie = /dfy_csrf=([^;]+)/.exec(form.headers.get("set-cookie") ?? "")?.[1];
2193 assert.ok(csrf && cookie);
2194 const fd = new FormData();
2195 for (const [k, v] of Object.entries({ _csrf: csrf, tag: "", new_tag: "v3.0.0", target: "main", name: "From the web", body: "Notes from the form.", latest: "1", action: "publish" })) fd.append(k, v);
2196 fd.append("assets", new Blob(["web upload\n"], { type: "text/plain" }), "web.txt");
2197 const submit = await fetch(`${base}/${owner}/${repo}/releases`, { method: "POST", body: fd, redirect: "manual", headers: { cookie: `dfy_csrf=${cookie}` } });
2198 assert.equal(submit.status, 303, await submit.text());
2199 assert.equal(submit.headers.get("location"), `/${owner}/${repo}/releases/tag/v3.0.0`);
2200 assert.equal(await (await fetch(`${base}/${owner}/${repo}/releases/download/v3.0.0/web.txt`)).text(), "web upload\n");
2201 assert.equal((await gh.rest.repos.getLatestRelease(R)).data.tag_name, "v3.0.0");
2202 assert.match(await (await fetch(`${base}/${owner}/${repo}`)).text(), /From the web/);
2203
2204 // ------------------------------------------------------------ General settings: website and topics, and what search engines see
2205 const before = (await gh.rest.repos.get(R)).data;
2206 const settingsPage = await fetch(`${base}/${owner}/${repo}/settings`);
2207 const settingsHtml = await settingsPage.text();
2208 assert.match(settingsHtml, /id="repo-homepage"/);
2209 assert.match(settingsHtml, /id="repo-topics"/);
2210 const saveGeneral = async (fields) => {
2211 const r = await fetch(`${base}/${owner}/${repo}/settings/general`, {
2212 method: "POST",
2213 body: new URLSearchParams({ _csrf: /name="_csrf" value="([^"]+)"/.exec(settingsHtml)[1], name: repo, description: before.description ?? "", default_branch: before.default_branch, ...fields }),
2214 redirect: "manual",
2215 headers: { cookie: `dfy_csrf=${/dfy_csrf=([^;]+)/.exec(settingsPage.headers.get("set-cookie") ?? "")[1]}`, "sec-fetch-site": "same-origin" },
2216 });
2217 assert.equal(r.status, 303, await r.text());
2218 return (await gh.rest.repos.get(R)).data;
2219 };
2220 let saved = await saveGeneral({ visibility: "public", homepage: "https://example.com/project", topics: "Cloudflare ci, git ci" });
2221 assert.equal(saved.homepage, "https://example.com/project");
2222 assert.deepEqual(saved.topics, ["cloudflare", "ci", "git"]);
2223 const homePage = await (await fetch(`${base}/${owner}/${repo}`)).text();
2224 assert.match(homePage, /<a href="https:\/\/example.com\/project" rel="noopener nofollow ugc">example.com\/project<\/a>/);
2225 const ld = JSON.stringify(JSON.parse(/<script type="application\/ld\+json"[^>]*>([^<]+)<\/script>/.exec(homePage)[1]));
2226 assert.match(ld, /"@type":"SoftwareSourceCode"/);
2227 assert.match(ld, /"keywords":"cloudflare, ci, git"/);
2228 // A form without the fields leaves them alone; bad values are refused.
2229 saved = await saveGeneral({ visibility: before.visibility });
2230 assert.deepEqual([saved.homepage, saved.topics, saved.visibility], ["https://example.com/project", ["cloudflare", "ci", "git"], before.visibility]);
2231 assert.doesNotMatch(await (await fetch(`${base}/${owner}/${repo}`)).text(), /SoftwareSourceCode/);
2232 await assert.rejects(gh.rest.repos.update({ ...R, homepage: "javascript:alert(1)" }), (e) => e.status === 422);
2233 assert.equal((await gh.rest.repos.update({ ...R, homepage: "" })).data.homepage, null);
2234 assert.equal((await gh.rest.repos.replaceAllTopics({ ...R, names: [] })).data.names.length, 0);
2235
2236 // ------------------------------------------------------------ issues: labels, assignees, lock, reactions, events, pagination
2237 await gh.rest.issues.createLabel({ ...R, name: "bug", color: "d73a4a", description: "Something is broken" });
2238 await assert.rejects(gh.rest.issues.createLabel({ ...R, name: "bug", color: "d73a4a" }), (e) => e.status === 422);
2239 const issue = await gh.rest.issues.create({ ...R, title: "Crash on start", body: "It crashes.", labels: ["bug"], assignees: [owner] });
2240 assert.deepEqual(issue.data.labels.map((l) => [l.name, l.color]), [["bug", "d73a4a"]]);
2241 assert.equal(issue.data.assignees[0].login, owner);
2242 assert.equal(issue.data.user.login, owner);
2243 assert.match(issue.data.html_url, new RegExp(`/${owner}/${repo}/issues/${issue.data.number}$`));
2244 const n = issue.data.number;
2245 await gh.rest.issues.addLabels({ ...R, issue_number: n, labels: ["triage"] });
2246 assert.deepEqual((await gh.rest.issues.listLabelsOnIssue({ ...R, issue_number: n })).data.map((l) => l.name).sort(), ["bug", "triage"]);
2247 await gh.rest.issues.removeLabel({ ...R, issue_number: n, name: "triage" });
2248 await gh.rest.issues.removeAssignees({ ...R, issue_number: n, assignees: [owner] });
2249 await gh.rest.issues.addAssignees({ ...R, issue_number: n, assignees: [owner] });
2250 assert.equal((await gh.rest.issues.checkUserCanBeAssigned({ ...R, assignee: owner })).status, 204);
2251 const comment = await gh.rest.issues.createComment({ ...R, issue_number: n, body: "Same here." });
2252 assert.equal(typeof comment.data.id, "number");
2253 assert.equal((await gh.rest.issues.getComment({ ...R, comment_id: comment.data.id })).data.body, "Same here.");
2254 await gh.rest.issues.updateComment({ ...R, comment_id: comment.data.id, body: "Same here!" });
2255 assert.equal((await gh.rest.issues.getComment({ ...R, comment_id: String(comment.data.id) })).data.body, "Same here!");
2256 await gh.rest.reactions.createForIssue({ ...R, issue_number: n, content: "+1" });
2257 const heart = await gh.rest.reactions.createForIssueComment({ ...R, comment_id: comment.data.id, content: "heart" });
2258 assert.equal(heart.status, 201);
2259 assert.equal((await gh.rest.reactions.createForIssueComment({ ...R, comment_id: comment.data.id, content: "heart" })).status, 200);
2260 assert.deepEqual((await gh.rest.reactions.listForIssue({ ...R, issue_number: n })).data.map((x) => x.content), ["+1"]);
2261 assert.equal((await gh.rest.issues.get({ ...R, issue_number: n })).data.reactions["+1"], 1);
2262 await gh.rest.issues.lock({ ...R, issue_number: n, lock_reason: "resolved" });
2263 const locked = await gh.rest.issues.get({ ...R, issue_number: n });
2264 assert.equal(locked.data.locked, true);
2265 assert.equal(locked.data.active_lock_reason, "resolved");
2266 await gh.rest.issues.unlock({ ...R, issue_number: n });
2267 await gh.rest.issues.update({ ...R, issue_number: n, title: "Crash on startup", state: "closed", state_reason: "completed" });
2268 const events = (await gh.rest.issues.listEvents({ ...R, issue_number: n })).data.map((e) => e.event);
2269 for (const e of ["labeled", "unlabeled", "unassigned", "assigned", "locked", "unlocked", "renamed", "closed"]) assert.ok(events.includes(e), `${e} in ${events}`);
2270 const timeline = (await gh.rest.issues.listEventsForTimeline({ ...R, issue_number: n })).data;
2271 assert.ok(timeline.some((e) => e.event === "commented" && e.body === "Same here!" && e.id === comment.data.id));
2272 assert.ok((await gh.rest.issues.listCommentsForRepo(R)).data.some((x) => x.id === comment.data.id));
2273 await gh.rest.issues.deleteComment({ ...R, comment_id: comment.data.id });
2274 await assert.rejects(gh.rest.issues.getComment({ ...R, comment_id: comment.data.id }), (e) => e.status === 404);
2275
2276 for (let i = 0; i < 3; i++) await gh.rest.issues.create({ ...R, title: `Paged ${i}` });
2277 const page1 = await gh.rest.issues.listForRepo({ ...R, state: "all", per_page: 2 });
2278 assert.equal(page1.data.length, 2);
2279 assert.match(page1.headers.link ?? "", /rel="next"/);
2280 const all = await gh.paginate(gh.rest.issues.listForRepo, { ...R, state: "all", per_page: 2 });
2281 assert.equal(new Set(all.map((x) => x.number)).size, all.length);
2282 assert.ok(all.length >= 5, `paginated ${all.length} issues and pull requests`);
2283
2284 // ------------------------------------------------------------ search, over readable repositories only
2285 const found = await until("issue search", async () => {
2286 const s = await gh.rest.search.issuesAndPullRequests({ q: `repo:${owner}/${repo} is:issue label:bug crash` });
2287 return s.data.total_count ? s.data : null;
2288 });
2289 assert.deepEqual(found.items.map((x) => x.number), [n]);
2290 assert.equal((await gh.rest.search.issuesAndPullRequests({ q: `repo:${owner}/${repo} is:pr is:merged` })).data.items[0].number, pr.data.number);
2291 assert.equal((await gh.rest.search.issuesAndPullRequests({ q: `repo:${owner}/${repo} is:issue -label:bug Paged`, sort: "created", order: "asc" })).data.items.map((x) => x.title).join(","), "Paged 0,Paged 1,Paged 2");
2292 await gh.rest.repos.replaceAllTopics({ ...R, names: ["octokit", "e2e"] });
2293 assert.deepEqual((await gh.rest.repos.getAllTopics(R)).data.names, ["octokit", "e2e"]);
2294 const repos = await gh.rest.search.repos({ q: `topic:octokit user:${owner}` });
2295 assert.deepEqual(repos.data.items.map((x) => x.full_name), [`${owner}/${repo}`]);
2296 assert.ok("TypeScript" in (await gh.rest.repos.listLanguages(R)).data);
2297
2298 // ------------------------------------------------------------ deployments and environments
2299 const env = await gh.rest.repos.createOrUpdateEnvironment({ ...R, environment_name: "staging" });
2300 assert.equal(env.data.name, "staging");
2301 const dep = await gh.rest.repos.createDeployment({ ...R, ref: "main", environment: "staging", auto_merge: false, required_contexts: [], payload: { region: "eu" }, description: "Deploy to staging" });
2302 assert.equal(dep.status, 201);
2303 assert.equal(dep.data.sha, (await gh.rest.git.getRef({ ...R, ref: "heads/main" })).data.object.sha);
2304 assert.deepEqual(dep.data.payload, { region: "eu" });
2305 await gh.rest.repos.createDeploymentStatus({ ...R, deployment_id: dep.data.id, state: "in_progress" });
2306 const ds = await gh.rest.repos.createDeploymentStatus({ ...R, deployment_id: dep.data.id, state: "success", environment_url: "https://staging.example.com", log_url: "https://ci.example.com/deploy/1" });
2307 assert.equal(ds.data.state, "success");
2308 assert.deepEqual((await gh.rest.repos.listDeploymentStatuses({ ...R, deployment_id: dep.data.id })).data.map((x) => x.state), ["success", "in_progress"]);
2309 assert.equal((await gh.rest.repos.listDeployments({ ...R, environment: "staging" })).data.length, 1);
2310 assert.ok((await gh.rest.repos.getAllEnvironments(R)).data.environments.some((e) => e.name === "staging"));
2311 await gh.rest.actions.createEnvironmentVariable({ ...R, environment_name: "staging", name: "REGION", value: "eu" });
2312 assert.equal((await gh.rest.actions.getEnvironmentVariable({ ...R, environment_name: "staging", name: "REGION" })).data.value, "eu");
2313 // The environment page sets deployment branches, their patterns and the environment's secrets.
2314 const envUrl = `${base}/${owner}/${repo}/settings/environments/staging`;
2315 const envForm = async (path, fields) => {
2316 const pageRes = await fetch(envUrl);
2317 const html = await pageRes.text();
2318 const r = await fetch(`${envUrl}${path}`, {
2319 method: "POST",
2320 body: new URLSearchParams({ _csrf: /name="_csrf" value="([^"]+)"/.exec(html)[1], ...fields }),
2321 redirect: "manual",
2322 headers: { cookie: `dfy_csrf=${/dfy_csrf=([^;]+)/.exec(pageRes.headers.get("set-cookie") ?? "")[1]}`, "sec-fetch-site": "same-origin" },
2323 });
2324 assert.equal(r.status, 303, await r.text());
2325 return html;
2326 };
2327 const envState = async () => (await gh.request("GET /repos/{owner}/{repo}/environments/{environment_name}", { ...R, environment_name: "staging" })).data.deployment_branch_policy;
2328 const envSecrets = async () => (await gh.request("GET /repos/{owner}/{repo}/environments/{environment_name}/secrets", { ...R, environment_name: "staging" })).data.secrets.map((x) => x.name);
2329 assert.match(await envForm("/secrets", { name: "deploy_key", value: "env-s3cret" }), /<input type="hidden" name="branch_policy" value="all"\/>/);
2330 assert.deepEqual(await envSecrets(), ["DEPLOY_KEY"]);
2331 assert.deepEqual(await envState(), { protected_branches: true, custom_branch_policies: false }, "the first secret limits the environment to protected branches");
2332 await envForm("", { reviewers: "", wait_timer: "0", branch_policy: "selected" });
2333 assert.deepEqual(await envState(), { protected_branches: false, custom_branch_policies: true });
2334 await envForm("/branch-policies", { name: "release/*", type: "tag" });
2335 const patterns = (await gh.request("GET /repos/{owner}/{repo}/environments/{environment_name}/deployment-branch-policies", { ...R, environment_name: "staging" })).data.branch_policies;
2336 assert.deepEqual(patterns.map((x) => [x.name, x.type]), [["release/*", "tag"]]);
2337 const envHtml = await envForm("/branch-policies/delete", { id: String(patterns[0].id) });
2338 assert.match(envHtml, /release\/\*/);
2339 assert.match(envHtml, /DEPLOY_KEY/);
2340 assert.doesNotMatch(envHtml, /env-s3cret/);
2341 assert.equal((await gh.request("GET /repos/{owner}/{repo}/environments/{environment_name}/deployment-branch-policies", { ...R, environment_name: "staging" })).data.total_count, 0);
2342 await envForm("", { reviewers: "", wait_timer: "0", branch_policy: "all" });
2343 assert.equal(await envState(), null);
2344 await envForm("/secrets/delete", { name: "DEPLOY_KEY" });
2345 assert.deepEqual(await envSecrets(), []);
2346 await gh.rest.repos.deleteAnEnvironment({ ...R, environment_name: "staging" });
2347
2348 // ------------------------------------------------------------ repository_dispatch and repository variables
2349 assert.equal((await gh.rest.repos.createDispatchEvent({ ...R, event_type: "deploy", client_payload: { env: "prod" } })).status, 204);
2350 await gh.rest.actions.createRepoVariable({ ...R, name: "COLOR", value: "blue" });
2351 await gh.rest.actions.updateRepoVariable({ ...R, name: "COLOR", value: "green" });
2352 assert.equal((await gh.rest.actions.getRepoVariable({ ...R, name: "COLOR" })).data.value, "green");
2353});
2354
2355/** A small opaque RGBA PNG (a gradient), built by hand so the test needs no image tools. */
2356function pngGradient(width, height) {
2357 const chunk = (type, body) => {
2358 const out = Buffer.alloc(12 + body.length);
2359 out.writeUInt32BE(body.length, 0);
2360 out.write(type, 4, "latin1");
2361 body.copy(out, 8);
2362 out.writeUInt32BE(crc32(out.subarray(4, 8 + body.length)), 8 + body.length);
2363 return out;
2364 };
2365 const ihdr = Buffer.alloc(13);
2366 ihdr.writeUInt32BE(width, 0);
2367 ihdr.writeUInt32BE(height, 4);
2368 ihdr.set([8, 6, 0, 0, 0], 8);
2369 const raw = Buffer.alloc((width * 4 + 1) * height);
2370 for (let y = 0; y < height; y++)
2371 for (let x = 0; x < width; x++) raw.set([(x * 255) / width, (y * 255) / height, 128, 255], y * (width * 4 + 1) + 1 + x * 4);
2372 return Buffer.concat([Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]), chunk("IHDR", ihdr), chunk("IDAT", deflateSync(raw)), chunk("IEND", Buffer.alloc(0))]);
2373}
2374
2375/** Width and height of a lossy or extended WebP, or null when it is not one. */
2376function webpSize(b) {
2377 if (b.toString("latin1", 0, 4) !== "RIFF" || b.toString("latin1", 8, 12) !== "WEBP") return null;
2378 const chunk = b.toString("latin1", 12, 16);
2379 if (chunk === "VP8 ") return { width: b.readUInt16LE(26) & 0x3fff, height: b.readUInt16LE(28) & 0x3fff };
2380 if (chunk === "VP8X") return { width: b.readUIntLE(24, 3) + 1, height: b.readUIntLE(27, 3) + 1 };
2381 return null;
2382}
2383
2384test("people and profiles: visibility, repository invitations, blank names and usernames", async () => {
2385 const me = await ok("GET", "/user");
2386 // A form post as the signed-in dev user, with the CSRF double-submit pair taken from `page`.
2387 const submit = async (page, action, fields) => {
2388 const res = await fetch(`${base}${page}`);
2389 const csrf = /name="_csrf" value="([^"]+)"/.exec(await res.text())?.[1];
2390 const cookie = /dfy_csrf=([^;]+)/.exec(res.headers.get("set-cookie") ?? "")?.[1];
2391 assert.ok(csrf && cookie, `no CSRF pair on ${page}`);
2392 return fetch(`${base}${action}`, { method: "POST", body: new URLSearchParams({ _csrf: csrf, ...fields }), redirect: "manual", headers: { cookie: `dfy_csrf=${cookie}`, "sec-fetch-site": "same-origin" } });
2393 };
2394 const flashOf = (res) => decodeURIComponent(decodeURIComponent(res.headers.get("set-cookie") ?? ""));
2395
2396 // "internal" is gone: creating and updating refuse it the same way.
2397 const created = await api("POST", "/user/repos", { name: "people-rules", visibility: "internal" });
2398 assert.equal(created.status, 422);
2399 await ok("POST", "/user/repos", { name: "people-rules" });
2400 const patched = await api("PATCH", `/repos/${me.login}/people-rules`, { visibility: "internal" });
2401 assert.equal(patched.status, 422);
2402 assert.equal(created.json.message, patched.json.message);
2403 assert.deepEqual(created.json.errors, patched.json.errors);
2404
2405 // Inviting the same email to a repository twice (any letter case) is refused.
2406 const access = `/${me.login}/people-rules/settings/access`;
2407 const first = await submit(access, `${access}/people`, { who: "newcomer@example.com", role: "read" });
2408 assert.equal(first.status, 200, flashOf(first));
2409 assert.match(await first.text(), /newcomer@example\.com/);
2410 const second = await submit(access, `${access}/people`, { who: "NewComer@Example.com", role: "write" });
2411 assert.equal(second.status, 303);
2412 assert.match(flashOf(second), /already has a pending invitation/);
2413
2414 // ...and it can be revoked: on the access page, in the API and over MCP. Then the address can be invited again.
2415 const mcp = async (name, args) => {
2416 const r = await fetch(`${base}/mcp`, { method: "POST", headers: { authorization: `Bearer ${token}`, "content-type": "application/json", accept: "application/json, text/event-stream" }, body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name, arguments: args } }) });
2417 const { result } = await r.json();
2418 assert.equal(result.isError, false, result.content[0].text);
2419 return result.structuredContent;
2420 };
2421 const repoInvites = async () => ok("GET", `/repos/${me.login}/people-rules/invitations`);
2422 const [pending] = await repoInvites();
2423 assert.equal(pending.email, "newcomer@example.com");
2424 assert.match(await (await fetch(`${base}${access}`)).text(), new RegExp(`action="${access}/invites/${pending.id}/revoke"`));
2425 const revoked = await submit(access, `${access}/invites/${pending.id}/revoke`, {});
2426 assert.match(flashOf(revoked), /Invitation revoked/);
2427 assert.deepEqual(await repoInvites(), []);
2428 assert.equal((await submit(access, `${access}/people`, { who: "newcomer@example.com", role: "read" })).status, 200);
2429 const [again] = await repoInvites();
2430 assert.equal((await api("DELETE", `/repos/${me.login}/people-rules/invitations/${again.id}`)).status, 204);
2431 assert.equal((await api("DELETE", `/repos/${me.login}/people-rules/invitations/${again.id}`)).status, 404);
2432 await submit(access, `${access}/people`, { who: "newcomer@example.com", role: "read" });
2433 const listed = (await mcp("list_invitations", { owner: me.login, repo: "people-rules" })).result;
2434 assert.deepEqual(listed.map((i) => i.email), ["newcomer@example.com"]);
2435 assert.equal((await mcp("revoke_invitation", { owner: me.login, repo: "people-rules", invitation_id: listed[0].id })).revoked, true);
2436 assert.deepEqual(await repoInvites(), []);
2437
2438 // Organization and site invitations too; each revoke only reaches its own kind.
2439 await ok("POST", "/user/orgs", { login: "revokers" });
2440 const orgInvite = await ok("POST", "/orgs/revokers/invitations", { email: "joiner@example.com" });
2441 const siteInvite = await ok("POST", "/invitations", { email: "visitor@example.com" });
2442 assert.deepEqual((await ok("GET", "/orgs/revokers/invitations")).map((i) => i.id), [orgInvite.id]);
2443 const site = await ok("GET", "/invitations");
2444 assert.ok(site.some((i) => i.id === siteInvite.id) && !site.some((i) => i.id === orgInvite.id));
2445 assert.equal((await api("DELETE", `/invitations/${orgInvite.id}`)).status, 404);
2446 assert.equal((await api("DELETE", `/orgs/revokers/invitations/${siteInvite.id}`)).status, 404);
2447 assert.equal((await api("DELETE", `/orgs/revokers/invitations/${orgInvite.id}`)).status, 204);
2448 await ok("POST", "/orgs/revokers/invitations", { email: "joiner@example.com" });
2449 const [orgAgain] = (await mcp("list_invitations", { org: "revokers" })).result;
2450 assert.equal((await mcp("revoke_invitation", { org: "revokers", invitation_id: orgAgain.id })).revoked, true);
2451 assert.match(await (await fetch(`${base}/settings/admin`)).text(), new RegExp(`/settings/admin/invites/${siteInvite.id}/revoke`));
2452 assert.match(flashOf(await submit("/settings/admin", `/settings/admin/invites/${siteInvite.id}/revoke`, {})), /Invitation revoked/);
2453 assert.ok(!(await ok("GET", "/invitations")).some((i) => i.id === siteInvite.id));
2454
2455 // A blank display name falls back to the username.
2456 const saved = await submit("/settings", "/settings/profile", { login: me.login, name: " " });
2457 assert.match(flashOf(saved), /Profile saved\./);
2458 assert.equal((await ok("GET", `/users/${me.login}`)).name, null);
2459 assert.match(await (await fetch(`${base}/${me.login}`)).text(), new RegExp(`<h1[^>]*>${me.login}</h1>`));
2460
2461 // Usernames: the browser's pattern and the server agree that dots aren't allowed.
2462 const settings = await (await fetch(`${base}/settings`)).text();
2463 const pattern = /name="login"[^>]*pattern="([^"]+)"/.exec(settings)?.[1];
2464 assert.ok(pattern, "the username field has a pattern");
2465 assert.equal(new RegExp(`^(?:${pattern.replaceAll("&amp;", "&")})$`, "v").test("dot.name"), false);
2466 assert.equal((await api("POST", "/user/orgs", { login: "dot.name" })).status, 422);
2467});
2468
2469test("profile pictures: upload, resize, serve, cache headers and removal", async () => {
2470 const me = await ok("GET", "/user");
2471 const avatar = async (login, query = "") => {
2472 const r = await fetch(`${base}/api/avatars/${login}${query}`);
2473 assert.equal(r.status, 200);
2474 return { type: r.headers.get("content-type"), cache: r.headers.get("cache-control"), csp: r.headers.get("content-security-policy"), body: Buffer.from(await r.arrayBuffer()) };
2475 };
2476 const put = (path, body, tok = token) => fetch(`${base}/api/v3${path}`, { method: "PUT", headers: { authorization: `Bearer ${tok}`, "content-type": "image/png" }, body });
2477
2478 // Before any upload: generated initials, also for logins that don't exist.
2479 const initials = await avatar(me.login, "?s=64");
2480 assert.match(initials.type, /^image\/svg\+xml/);
2481 assert.equal(initials.csp, "default-src 'none'; style-src 'unsafe-inline'");
2482 assert.match((await avatar("no-such-user-here")).type, /^image\/svg\+xml/);
2483
2484 // REST upload: a 600×400 PNG becomes centred square WebPs.
2485 const up = await put("/user/avatar", pngGradient(600, 400));
2486 assert.equal(up.status, 200, await up.clone().text());
2487 const { avatar_url } = await up.json();
2488 const version = new URL(avatar_url).searchParams.get("v");
2489 assert.match(version ?? "", /^\d+$/);
2490 for (const s of [64, 128, 256]) {
2491 const a = await avatar(me.login, `?s=${s}&v=${version}`);
2492 assert.equal(a.type, "image/webp");
2493 assert.deepEqual(webpSize(a.body), { width: s, height: s });
2494 assert.ok(a.body.length < 10_000, `${s}px WebP is ${a.body.length} bytes`);
2495 assert.match(a.cache, /immutable/);
2496 }
2497 const current = await avatar(me.login, "?s=64");
2498 assert.equal(current.type, "image/webp");
2499 assert.match(current.cache, /max-age=600/);
2500
2501 // Only JPEG, PNG and WebP, sniffed from the bytes.
2502 const gif = await put("/user/avatar", Buffer.from("GIF89a\x01\x00\x01\x00\x00\x00\x00;", "latin1"));
2503 assert.equal(gif.status, 422);
2504 assert.equal((await gif.json()).message, "Use a JPEG, PNG or WebP image.");
2505 // Read-only tokens can't change a profile.
2506 const ro = (await ok("POST", "/diffinery/tokens", { name: "ro", scopes: ["read"] }, null)).token;
2507 assert.equal((await put("/user/avatar", pngGradient(8, 8), ro)).status, 403);
2508
2509 // The web form (multipart, CSRF double-submit) takes the original file and the server resizes it.
2510 const page = await fetch(`${base}/settings`);
2511 const csrf = /name="_csrf" value="([^"]+)"/.exec(await page.text())?.[1];
2512 const cookie = /dfy_csrf=([^;]+)/.exec(page.headers.get("set-cookie") ?? "")?.[1];
2513 assert.ok(csrf && cookie);
2514 const form = new FormData();
2515 form.set("_csrf", csrf);
2516 form.set("avatar", new Blob([pngGradient(300, 500)], { type: "image/png" }), "me.png");
2517 const posted = await fetch(`${base}/settings/avatar`, { method: "POST", body: form, redirect: "manual", headers: { cookie: `dfy_csrf=${cookie}`, "sec-fetch-site": "same-origin" } });
2518 assert.equal(posted.status, 303);
2519 assert.match(decodeURIComponent(decodeURIComponent(posted.headers.get("set-cookie") ?? "")), /"kind":"notice","message":"Profile picture updated\."/);
2520 const settings = await (await fetch(`${base}/settings`)).text();
2521 const newVersion = /\/api\/avatars\/[^"?]+\?s=256&amp;v=(\d+)/.exec(settings)?.[1];
2522 assert.ok(newVersion && newVersion !== version, "the settings page links the new version");
2523 // An old version's URL gets the current picture, but not as an immutable response.
2524 assert.match((await avatar(me.login, `?s=64&v=${version}`)).cache, /max-age=600/);
2525
2526 // Organizations: owners (admins get a 403; see the security tests).
2527 await ok("POST", "/user/orgs", { login: "picture-org" });
2528 const org = await put("/orgs/picture-org/avatar", pngGradient(64, 64));
2529 assert.equal(org.status, 200, await org.clone().text());
2530 assert.equal((await avatar("picture-org", "?s=128")).type, "image/webp");
2531 assert.equal((await fetch(`${base}/api/v3/orgs/picture-org/avatar`, { method: "DELETE", headers: { authorization: `Bearer ${token}` } })).status, 200);
2532 assert.match((await avatar("picture-org", "?s=128")).type, /^image\/svg\+xml/);
2533
2534 // Removal falls back to initials straight away (the cached copies are purged).
2535 const del = await fetch(`${base}/api/v3/user/avatar`, { method: "DELETE", headers: { authorization: `Bearer ${token}` } });
2536 assert.deepEqual(await del.json(), { avatar_url: `${base}/api/avatars/${me.login}` });
2537 assert.match((await avatar(me.login, "?s=64")).type, /^image\/svg\+xml/);
2538});
2539
2540// ---------------------------------------------------------------- GitHub imports
2541
2542/** Build the fake GitHub's repositories with real git: history with a merged pull request, a draft, a fork head, tags, LFS and an old secret. */
2543function githubFixture(root) {
2544 const g = (cwd, ...args) => execFileSync("git", args, { cwd, encoding: "utf8", env: { ...process.env, GIT_AUTHOR_NAME: "Octo", GIT_AUTHOR_EMAIL: "octo@example.com", GIT_COMMITTER_NAME: "Octo", GIT_COMMITTER_EMAIL: "octo@example.com" } }).trim();
2545 const src = join(root, "work-app");
2546 mkdirSync(join(src, ".github/workflows"), { recursive: true });
2547 g(root, "init", "-q", "-b", "main", src);
2548 const asset = lfsObject(`binary asset ${randomBytes(8).toString("hex")}\n`);
2549 writeFileSync(join(src, "README.md"), "# app\n");
2550 writeFileSync(join(src, ".gitattributes"), "*.bin filter=lfs diff=lfs merge=lfs -text\n");
2551 writeFileSync(join(src, "asset.bin"), asset.pointer);
2552 // Would start a run on every push if imports fired workflows.
2553 writeFileSync(join(src, ".github/workflows/ci.yml"), "name: CI\non: [push, pull_request]\njobs:\n build:\n runs-on: [self-hosted, linux]\n steps:\n - run: echo hi\n");
2554 // A credential committed long ago (built here so this file has none).
2555 writeFileSync(join(src, "settings.env"), `AWS_ACCESS_KEY_ID=${"AKIA"}${"Q3EGRK5V7XJZ2MWN"}\n`);
2556 g(src, "add", "-A");
2557 g(src, "-c", "core.hooksPath=/dev/null", "commit", "-q", "-m", "initial");
2558 g(src, "tag", "v0.1");
2559 g(src, "rm", "-q", "settings.env");
2560 g(src, "commit", "-q", "-m", "remove credentials");
2561 // Enough data that a small push budget needs several chunks.
2562 for (let i = 0; i < 4; i++) {
2563 writeFileSync(join(src, `data${i}.bin.txt`), randomBytes(90 * 1024).toString("base64"));
2564 g(src, "add", "-A");
2565 g(src, "commit", "-q", "-m", `data ${i}`);
2566 }
2567 g(src, "checkout", "-q", "-b", "feature");
2568 writeFileSync(join(src, "feature.txt"), "feature\n");
2569 g(src, "add", "-A");
2570 g(src, "commit", "-q", "-m", "feature");
2571 const featureSha = g(src, "rev-parse", "HEAD");
2572 g(src, "checkout", "-q", "main");
2573 g(src, "merge", "-q", "--no-ff", "-m", "Merge pull request #2 from octo/feature", "feature");
2574 const mergeSha = g(src, "rev-parse", "HEAD");
2575 g(src, "tag", "-a", "v1.0", "-m", "Version 1.0");
2576 g(src, "checkout", "-q", "-b", "draft-work");
2577 writeFileSync(join(src, "draft.txt"), "wip\n");
2578 g(src, "add", "-A");
2579 g(src, "commit", "-q", "-m", "draft");
2580 const draftSha = g(src, "rev-parse", "HEAD");
2581 // A fork's commit: only GitHub's refs/pull/6/head points at it.
2582 g(src, "checkout", "-q", "--detach", "main");
2583 writeFileSync(join(src, "fork.txt"), "from a fork\n");
2584 g(src, "add", "-A");
2585 g(src, "commit", "-q", "-m", "fork change");
2586 const forkSha = g(src, "rev-parse", "HEAD");
2587 g(src, "checkout", "-q", "main");
2588 const bare = join(root, "octo", "app.git");
2589 mkdirSync(join(root, "octo"), { recursive: true });
2590 g(root, "clone", "-q", "--bare", src, bare);
2591 g(bare, "update-ref", "refs/pull/2/head", featureSha);
2592 g(bare, "update-ref", "refs/pull/2/merge", mergeSha);
2593 g(bare, "update-ref", "refs/pull/5/head", draftSha);
2594 g(bare, "update-ref", "refs/pull/6/head", forkSha);
2595 g(bare, "update-ref", "refs/heads/gh-readonly-queue/main/pr-9-0123456789abcdef", mergeSha);
2596 // A second repository for the organization import.
2597 const lib = join(root, "work-lib");
2598 g(root, "init", "-q", "-b", "trunk", lib);
2599 writeFileSync(join(lib, "lib.txt"), "lib\n");
2600 g(lib, "add", "-A");
2601 g(lib, "commit", "-q", "-m", "lib");
2602 g(root, "clone", "-q", "--bare", lib, join(root, "octo", "lib.git"));
2603 return { asset, featureSha, mergeSha, draftSha, forkSha, mainSha: mergeSha };
2604}
2605
2606test("import from GitHub: git data, issues and pull requests with their numbers, no side effects", async () => {
2607 const me = await ok("GET", "/user");
2608 const owner = me.login;
2609 const ghRoot = join(work, "github");
2610 const fx = githubFixture(ghRoot);
2611 const GH_TOKEN = `ghfake${randomBytes(12).toString("hex")}`;
2612 const t = "2024-01-02T03:04:05Z";
2613 const u = (login, id) => ({ login, id, type: "User" });
2614 const octoDev = u("octo-dev", 1001);
2615 const alice = u("alice", 2001);
2616 const bob = u("bob", 3001);
2617 let ghBase;
2618 let linkNonce = ""; // set from the link challenge, then served back in octo-dev's public gist
2619 let listHuge = false; // the organization lists an oversized repository once set
2620 const pr = (number, extra) => ({ number, title: `PR ${number}`, body: `Body of #${number}`, state: "open", user: alice, labels: [], assignees: [], milestone: null, locked: false, created_at: t, updated_at: t, closed_at: null, draft: false, merged_at: null, merge_commit_sha: null, requested_reviewers: [], head: { ref: "x", sha: fx.mainSha, label: "octo:x", repo: { full_name: "octo/app" } }, base: { ref: "main", repo: { full_name: "octo/app" } }, ...extra });
2621 const issue = (number, extra) => ({ number, title: `Issue ${number}`, body: `Body of #${number}`, state: "open", state_reason: null, user: octoDev, labels: [], assignees: [], milestone: null, locked: false, created_at: t, updated_at: t, closed_at: null, ...extra });
2622 const pulls = [
2623 pr(2, { title: "Add feature", state: "closed", closed_at: "2024-02-01T00:00:00Z", merged_at: "2024-02-01T00:00:00Z", merge_commit_sha: fx.mergeSha, labels: [{ name: "docs" }], head: { ref: "feature", sha: fx.featureSha, label: "octo:feature", repo: { full_name: "octo/app" } } }),
2624 pr(5, { title: "Work in progress", draft: true, requested_reviewers: [bob], head: { ref: "draft-work", sha: fx.draftSha, label: "octo:draft-work", repo: { full_name: "octo/app" } } }),
2625 pr(6, { title: "From a fork", state: "closed", closed_at: "2024-03-01T00:00:00Z", head: { ref: "patch", sha: fx.forkSha, label: "forker:patch", repo: { full_name: "forker/app" } } }),
2626 ];
2627 const issues = [
2628 issue(1, { title: "First bug", labels: [{ name: "bug", color: "d73a4a" }], assignees: [octoDev], milestone: { number: 1 } }),
2629 ...pulls.map((p) => ({ ...p, pull_request: { url: "x" } })),
2630 issue(3, { title: "Won't fix", user: alice, state: "closed", state_reason: "not_planned", closed_at: "2024-01-05T00:00:00Z", locked: true }),
2631 // #4 was deleted on GitHub: the number stays unused.
2632 issue(7, { title: "Latest", user: { login: "ghost-user", id: 9999 } }),
2633 ];
2634 const repoJson = (name, extra) => ({ name, full_name: `octo/${name}`, owner: { login: "octo" }, private: true, visibility: "private", fork: false, archived: false, description: `The ${name}`, homepage: "https://app.example.com", topics: ["demo", "import"], default_branch: "main", ...extra });
2635 const empty = [];
2636 const routes = {
2637 "GET /user": octoDev,
2638 // Gist-proof account linking: octo-dev's public profile, their gists, and the gist body with the nonce.
2639 "GET /users/octo-dev": octoDev,
2640 "GET /users/octo-dev/gists": () => [{ id: "proofgist", public: true, description: "", files: { "proof.md": { raw_url: `${ghBase}/raw/proofgist` } } }],
2641 "GET /gists/proofgist": () => ({ files: { "proof.md": { content: `linking to diffinery: ${linkNonce}` } } }),
2642 "GET /users/octo": { login: "octo", type: "Organization" },
2643 "GET /orgs/octo/repos": () => [repoJson("app"), repoJson("lib", { default_branch: "trunk", topics: [] }), ...(listHuge ? [repoJson("huge", { size: 99_999_999 })] : [])].map((r) => ({ ...r, clone_url: `${ghBase}/${r.full_name}.git` })),
2644 "GET /repos/octo/huge": () => ({ ...repoJson("huge", { size: 99_999_999 }), clone_url: `${ghBase}/octo/huge.git` }),
2645 // Only ORG_REGION reaches every repository on GitHub; Diffinery's organization variables always do.
2646 "GET /orgs/octo/actions/variables": { variables: [{ name: "ORG_REGION", value: "eu-west", visibility: "all" }, { name: "ORG_PRIVATE_HOST", value: "internal.example", visibility: "private" }, { name: "ORG_SELECTED_KEY", value: "few", visibility: "selected" }] },
2647 "GET /orgs/octo/actions/secrets": { secrets: [{ name: "ORG_DEPLOY_KEY" }] },
2648 "GET /repos/octo/app": () => ({ ...repoJson("app"), clone_url: `${ghBase}/octo/app.git`, html_url: `${ghBase}/octo/app` }),
2649 "GET /repos/octo/app/labels": [{ name: "bug", color: "d73a4a", description: "Something isn't working" }, { name: "docs", color: "0075ca", description: "Documentation" }, { name: "wontfix", color: "ffffff", description: "" }],
2650 "GET /repos/octo/app/milestones": [{ number: 1, title: "v1", description: "First release", state: "open", due_on: "2030-01-01T00:00:00Z", created_at: t, updated_at: t, closed_at: null, creator: octoDev }],
2651 "GET /repos/octo/app/pulls": pulls,
2652 "GET /repos/octo/app/issues": issues,
2653 "GET /repos/octo/app/issues/comments": () => [
2654 { id: 11, body: "I can reproduce this", user: alice, created_at: "2024-01-03T00:00:00Z", updated_at: "2024-01-03T00:00:00Z", issue_url: `${ghBase}/api/v3/repos/octo/app/issues/1` },
2655 { id: 12, body: "Thanks!", user: octoDev, created_at: "2024-01-04T00:00:00Z", updated_at: "2024-01-04T00:00:00Z", issue_url: `${ghBase}/api/v3/repos/octo/app/issues/1` },
2656 { id: 13, body: "Merging this", user: octoDev, created_at: "2024-01-31T00:00:00Z", updated_at: "2024-01-31T00:00:00Z", issue_url: `${ghBase}/api/v3/repos/octo/app/issues/2` },
2657 ],
2658 "GET /repos/octo/app/pulls/2/reviews": [{ id: 501, user: bob, state: "APPROVED", body: "Looks good", commit_id: fx.featureSha, submitted_at: "2024-01-30T00:00:00Z" }],
2659 "GET /repos/octo/app/pulls/5/reviews": [{ id: 505, user: octoDev, state: "APPROVED", body: "looks fine", commit_id: fx.draftSha, submitted_at: "2024-01-20T00:00:00Z" }],
2660 "GET /repos/octo/app/pulls/6/reviews": [{ id: 502, user: alice, state: "PENDING", body: "", commit_id: fx.forkSha, submitted_at: null }],
2661 "GET /repos/octo/app/pulls/2": { ...pulls[0], merged_by: octoDev },
2662 "GET /repos/octo/app/pulls/comments": () => [
2663 { id: 601, pull_request_review_id: 501, pull_request_url: `${ghBase}/api/v3/repos/octo/app/pulls/2`, user: bob, body: "Nice file", path: "feature.txt", line: 1, side: "RIGHT", commit_id: fx.featureSha, created_at: "2024-01-30T00:00:00Z", updated_at: "2024-01-30T00:00:00Z" },
2664 { id: 602, pull_request_review_id: 503, pull_request_url: `${ghBase}/api/v3/repos/octo/app/pulls/2`, in_reply_to_id: 601, user: alice, body: "Agreed", path: "feature.txt", line: 1, side: "RIGHT", commit_id: fx.featureSha, created_at: "2024-01-30T01:00:00Z", updated_at: "2024-01-30T01:00:00Z" },
2665 ],
2666 "GET /repos/octo/app/branches": [{ name: "main" }],
2667 "GET /repos/octo/app/branches/main/protection": { required_status_checks: { contexts: ["build"] }, required_pull_request_reviews: { required_approving_review_count: 1, dismiss_stale_reviews: true }, enforce_admins: { enabled: false }, allow_force_pushes: { enabled: false } },
2668 "GET /repos/octo/app/actions/variables": { variables: [{ name: "DEPLOY_ENV", value: "staging" }, { name: "REGION", value: "us" }] },
2669 "GET /repos/octo/app/actions/secrets": { secrets: [{ name: "NPM_TOKEN" }, { name: "SLACK_WEBHOOK" }] },
2670 "GET /repos/octo/app/releases": [{ id: 1, tag_name: "v1.0.0", name: "1.0.0", body: "first release", draft: false, prerelease: false, created_at: "2024-01-01T00:00:00Z", published_at: "2024-01-01T00:00:00Z", author: { login: "octocat", id: 1 }, assets: [] }],
2671 "GET /repos/octo/lib": () => ({ ...repoJson("lib", { default_branch: "trunk", topics: [] }), clone_url: `${ghBase}/octo/lib.git` }),
2672 "GET /repos/octo/lib/labels": empty,
2673 "GET /repos/octo/lib/milestones": empty,
2674 "GET /repos/octo/lib/pulls": empty,
2675 "GET /repos/octo/lib/issues": [issue(1, { title: "Lib issue" })],
2676 "GET /repos/octo/lib/issues/comments": empty,
2677 "GET /repos/octo/lib/pulls/comments": empty,
2678 "GET /repos/octo/lib/branches": empty,
2679 "GET /repos/octo/lib/actions/variables": { variables: [] },
2680 "GET /repos/octo/lib/actions/secrets": { secrets: [] },
2681 "GET /repos/octo/lib/releases": empty,
2682 };
2683 const gh = fakeGitHub({ root: ghRoot, token: GH_TOKEN, routes, lfs: new Map([[fx.asset.oid, fx.asset.data]]), anonymous: ["octo/lib"] });
2684 ghBase = await gh.listen();
2685 const apiUrl = `${ghBase}/api/v3`;
2686
2687 /** Run the import agent (the runner image's import mode) for an import waiting for one, like the container would. */
2688 const transfer = async (id) => {
2689 await until(`import ${id} to wait for an agent`, async () => (await ok("GET", `/diffinery/imports/${id}`)).git?.phase === "waiting", 120_000);
2690 const { token: pushToken } = await ok("POST", `/diffinery/imports/${id}/claim`);
2691 const r = await spawnAsync(process.execPath, [AGENT], { DIFFINERY_API_URL: base, DIFFINERY_IMPORT_ID: id, DIFFINERY_IMPORT_TOKEN: pushToken, DIFFINERY_IMPORT_CHUNK_BYTES: String(160 * 1024), DIFFINERY_IMPORT_LARGE_BLOB_BYTES: String(100 * 1024), DIFFINERY_WORK_ROOT: join(work, `import-${id}`) }, 240_000);
2692 const out = `${r.stdout}${r.stderr}`;
2693 assert.ok(!out.includes(GH_TOKEN) && !out.includes(pushToken), "the agent never prints tokens");
2694 return { ...r, out, pushToken };
2695 };
2696 const finished = (id, timeout = 180_000) =>
2697 until(`import ${id} to finish`, async () => {
2698 const r = await ok("GET", `/diffinery/imports/${id}`);
2699 return ["succeeded", "failed", "cancelled"].includes(r.status) ? r : null;
2700 }, timeout);
2701
2702 // ------------------------------------------------------------ people: link a GitHub account by gist proof (no token)
2703 const challenge = await ok("POST", "/diffinery/user/linked-accounts/github/challenge", { api_url: apiUrl });
2704 assert.match(challenge.nonce, /^diffinery-link-[0-9a-f]+$/);
2705 // Before the gist carries the nonce, linking is refused.
2706 assert.equal((await api("POST", "/diffinery/user/linked-accounts/github", { login: "octo-dev", api_url: apiUrl })).status, 422);
2707 linkNonce = challenge.nonce; // now octo-dev's public gist contains it
2708 const link = await ok("POST", "/diffinery/user/linked-accounts/github", { login: "octo-dev", api_url: apiUrl });
2709 assert.equal(link.login, "octo-dev");
2710
2711 // ------------------------------------------------------------ input validation and permissions
2712 assert.equal((await api("POST", "/diffinery/imports", { source: "octo/app", owner, options: { nope: true }, github_api_url: apiUrl })).status, 422);
2713 assert.equal((await api("POST", "/diffinery/imports", { source: "octo/app", owner: "nobody-here", github_api_url: apiUrl })).status, 422);
2714 assert.equal((await api("POST", "/diffinery/imports", { source: "octo/app", owner, github_token: "wrong", github_api_url: apiUrl })).status, 422);
2715 const bot = (await ok("POST", "/diffinery/agents", { login: "import-bot" }, null)).token.token;
2716 // An agent may import where its owner may, its owner's own account included: this one gets past
2717 // the permission check and stops only because the GitHub repository does not exist.
2718 const botTry = await api("POST", "/diffinery/imports", { source: "octo/missing", owner, github_token: GH_TOKEN, github_api_url: apiUrl }, bot);
2719 assert.equal(botTry.status, 422, JSON.stringify(botTry.json));
2720 assert.match(botTry.json.message, /octo\/missing was not found/);
2721
2722 // ------------------------------------------------------------ one repository
2723 const started = await ok("POST", "/diffinery/imports", { source: "octo/app", owner, name: "imported-app", github_token: GH_TOKEN, github_api_url: apiUrl });
2724 assert.equal(started.status, "queued");
2725 assert.ok(!JSON.stringify(started).includes(GH_TOKEN), "the token is never returned");
2726 // While the import holds the repository it created, nothing else writes to it but settings such as
2727 // secrets: the REST API, the web UI and MCP get 423 Locked (reads still work). The import's own
2728 // writes go through below.
2729 await until(`import ${started.id} to wait for an agent`, async () => (await ok("GET", `/diffinery/imports/${started.id}`)).git?.phase === "waiting", 120_000);
2730 const L = `/repos/${owner}/imported-app`;
2731 for (const [method, path, body] of [
2732 ["POST", `${L}/hooks`, { config: { url: "https://hooks.invalid/import-sink" }, events: ["*"] }],
2733 ["POST", `${L}/issues`, { title: "too early" }],
2734 ["PUT", `${L}/contents/early.txt`, { message: "too early", content: Buffer.from("early\n").toString("base64") }],
2735 ["POST", `${L}/labels`, { name: "early", color: "ffffff" }],
2736 ["PATCH", L, { description: "changed during the import" }],
2737 ]) {
2738 const r = await api(method, path, body);
2739 assert.equal(r.status, 423, `${method} ${path} -> ${r.status} ${JSON.stringify(r.json)}`);
2740 assert.match(r.json.message, /locked by an import/);
2741 }
2742 assert.equal((await api("GET", `${L}/issues`)).status, 200, "reads are not locked");
2743 // Settings that don't touch Git data, issues or pull requests can be set up while it imports.
2744 assert.equal((await api("PUT", `${L}/actions/secrets/EARLY_SECRET`, { value: "set during the import" })).status, 204);
2745 assert.ok((await ok("GET", `${L}/actions/secrets`)).secrets.some((x) => x.name === "EARLY_SECRET"));
2746 assert.equal((await api("DELETE", `${L}/actions/secrets/EARLY_SECRET`)).status, 204);
2747 const csrf = randomBytes(16).toString("hex");
2748 const webWrite = await fetch(`${base}/${owner}/imported-app/issues`, { method: "POST", headers: { cookie: `dfy_csrf=${csrf}`, "content-type": "application/x-www-form-urlencoded" }, body: new URLSearchParams({ _csrf: csrf, title: "too early" }), redirect: "manual" });
2749 assert.equal(webWrite.status, 423, await webWrite.text());
2750 const mcpWrite = await fetch(`${base}/mcp`, { method: "POST", headers: { authorization: `Bearer ${token}`, "content-type": "application/json", accept: "application/json, text/event-stream" }, body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name: "create_issue", arguments: { owner, repo: "imported-app", title: "too early" } } }) }).then((r) => r.json());
2751 assert.equal(mcpWrite.result.isError, true, JSON.stringify(mcpWrite));
2752 assert.match(mcpWrite.result.content[0].text, /locked by an import/);
2753 const agent = await transfer(started.id);
2754 assert.equal(agent.status, 0, agent.out);
2755 const done = await finished(started.id);
2756 assert.equal(done.status, "succeeded", JSON.stringify(done, null, 2));
2757 // No side effects: no workflow runs (ci.yml runs on push and pull_request), no webhook deliveries.
2758 // The lock is released: a webhook can be added now, and nothing the import queued reaches it.
2759 const hook = await ok("POST", `/repos/${owner}/imported-app/hooks`, { config: { url: "https://hooks.invalid/import-sink" }, events: ["*"] });
2760 await sleep(2000);
2761 assert.equal((await ok("GET", `/repos/${owner}/imported-app/actions/runs`)).total_count, 0);
2762 const sink = (await ok("GET", `/repos/${owner}/imported-app/hooks`)).find((h) => h.id === hook.id);
2763 assert.equal(sink.last_response.code, null, "no webhook was delivered");
2764 assert.equal(sink.last_response.status, "unused");
2765 assert.ok(done.steps.every((s) => s.status === "done" || s.status === "skipped"), JSON.stringify(done.steps));
2766 assert.ok(done.summary.git.chunks >= 3, `history went in chunks: ${JSON.stringify(done.summary.git)}`);
2767 // The data files count as large here (DIFFINERY_IMPORT_LARGE_BLOB_BYTES): they went first, whole,
2768 // under temporary refs naming trees, which the server takes and the import removes at the end.
2769 assert.match(agent.out, /4 version\(s\) of large files/);
2770 assert.equal(done.summary.git.branches, 3);
2771 assert.equal(done.summary.git.tags, 2);
2772 assert.equal(done.summary.git.lfsObjects, 1);
2773 assert.deepEqual(done.summary.secretNames, ["NPM_TOKEN", "SLACK_WEBHOOK"]);
2774 assert.ok(done.summary.findings.some((f) => f.kind === "AWS access key"), "bypassed findings are listed");
2775 assert.ok(done.summary.people.imported.includes("alice") && done.summary.people.linked.includes("octo-dev"));
2776 // Releases are imported over the REST API (not just their tags).
2777 assert.equal(done.summary.releases?.imported, 1, JSON.stringify(done.summary.releases));
2778 const releases = await ok("GET", `/repos/${owner}/imported-app/releases`);
2779 assert.deepEqual(releases.map((r) => r.tag_name), ["v1.0.0"]);
2780
2781 // Repository settings
2782 const repo = await ok("GET", `/repos/${owner}/imported-app`);
2783 assert.equal(repo.visibility, "private");
2784 assert.equal(repo.default_branch, "main");
2785 assert.equal(repo.description, "The app");
2786 assert.equal(repo.homepage, "https://app.example.com");
2787 assert.deepEqual(repo.topics, ["demo", "import"]);
2788
2789 // Git: branches, tags and pull request heads; no merge queue branches, merge refs or import refs.
2790 const refs = Object.fromEntries(
2791 git(work, ["ls-remote", `${base}/${owner}/imported-app.git`])
2792 .trim()
2793 .split("\n")
2794 .map((l) => l.split("\t").reverse()),
2795 );
2796 assert.equal(refs["refs/heads/main"], fx.mainSha);
2797 assert.equal(refs["refs/heads/feature"], fx.featureSha);
2798 assert.equal(refs["refs/heads/draft-work"], fx.draftSha);
2799 assert.ok(refs["refs/tags/v1.0"] && refs["refs/tags/v0.1"]);
2800 assert.equal(refs["refs/pull/2/head"], fx.featureSha);
2801 assert.equal(refs["refs/pull/5/head"], fx.draftSha);
2802 assert.equal(refs["refs/pull/6/head"], fx.forkSha);
2803 assert.ok(!Object.keys(refs).some((r) => r.startsWith("refs/heads/gh-readonly-queue/") || r.startsWith("refs/diffinery-import/") || r === "refs/pull/2/merge"), Object.keys(refs).join("\n"));
2804 const copy = join(work, "imported-app");
2805 git(work, ["clone", "-q", "--mirror", `${base}/${owner}/imported-app.git`, copy], token, { env: { ...process.env, GIT_LFS_SKIP_SMUDGE: "1", GIT_TERMINAL_PROMPT: "0" } });
2806 git(copy, ["fsck", "--no-progress"]);
2807 git(copy, ["cat-file", "-e", fx.forkSha]);
2808 // The LFS object is stored in Diffinery.
2809 const lfsRes = await fetch(`${base}/${owner}/imported-app.git/info/lfs/objects/batch`, { method: "POST", headers: { authorization: `Bearer ${token}`, "content-type": "application/vnd.git-lfs+json" }, body: JSON.stringify({ operation: "download", objects: [{ oid: fx.asset.oid, size: fx.asset.data.length }] }) });
2810 const lfsBody = await lfsRes.json();
2811 assert.ok(lfsBody.objects[0].actions?.download, `${JSON.stringify(lfsBody)}\n${JSON.stringify(done.warnings)}\n${agent.out}\n${devLog().split("\n").filter((l) => /lfs|rror/i.test(l)).slice(-40).join("\n")}`);
2812 const blob = await fetch(lfsBody.objects[0].actions.download.href, { headers: { authorization: `Bearer ${token}` } });
2813 assert.equal(Buffer.from(await blob.arrayBuffer()).toString(), fx.asset.data.toString());
2814 // The push token is revoked.
2815 assert.equal((await api("GET", "/user", undefined, agent.pushToken)).status, 401);
2816
2817 // Issues keep their numbers, people, state and dates.
2818 const i1 = await ok("GET", `/repos/${owner}/imported-app/issues/1`);
2819 assert.equal(i1.title, "First bug");
2820 assert.equal(i1.user.login, owner, "a linked GitHub account maps to its Diffinery account");
2821 assert.deepEqual(i1.assignees.map((a) => a.login), [owner]);
2822 assert.deepEqual(i1.labels.map((l) => l.name), ["bug"]);
2823 assert.equal(i1.milestone.title, "v1");
2824 assert.equal(i1.created_at, t);
2825 const i3 = await ok("GET", `/repos/${owner}/imported-app/issues/3`);
2826 assert.equal(i3.state, "closed");
2827 assert.equal(i3.state_reason, "not_planned");
2828 assert.equal(i3.user.login, "github:alice");
2829 assert.equal((await api("GET", `/repos/${owner}/imported-app/issues/4`)).status, 404, "a deleted GitHub issue leaves its number unused");
2830 const c1 = await ok("GET", `/repos/${owner}/imported-app/issues/1/comments`);
2831 assert.deepEqual(c1.map((c) => [c.user.login, c.body, c.created_at]), [["github:alice", "I can reproduce this", "2024-01-03T00:00:00Z"], [owner, "Thanks!", "2024-01-04T00:00:00Z"]]);
2832 // Pull requests: merged state, who merged, reviews and line comments with replies.
2833 const p2 = await ok("GET", `/repos/${owner}/imported-app/pulls/2`);
2834 assert.equal(p2.merged, true);
2835 assert.equal(p2.merged_by.login, owner);
2836 assert.equal(p2.merge_commit_sha, fx.mergeSha);
2837 assert.equal(p2.head.ref, "feature");
2838 assert.equal(p2.head.sha, fx.featureSha);
2839 const reviews = await ok("GET", `/repos/${owner}/imported-app/pulls/2/reviews`);
2840 assert.deepEqual(reviews.map((r) => [r.user.login, r.state, r.body]), [["github:bob", "APPROVED", "Looks good"]]);
2841 const lineComments = await ok("GET", `/repos/${owner}/imported-app/pulls/2/comments`);
2842 assert.equal(lineComments.length, 2);
2843 assert.equal(lineComments[0].path, "feature.txt");
2844 assert.equal(lineComments[1].in_reply_to_id, lineComments[0].id);
2845 const p5 = await ok("GET", `/repos/${owner}/imported-app/pulls/5`);
2846 assert.equal(p5.draft, true);
2847 assert.equal(p5.state, "open");
2848 assert.deepEqual(p5.requested_reviewers.map((r) => r.login), ["github:bob"]);
2849 // M1: an imported review is history, not a vote — even when its author is a linked Diffinery account.
2850 const r5 = await ok("GET", `/repos/${owner}/imported-app/pulls/5/reviews`);
2851 assert.deepEqual(r5.map((r) => [r.user.login, r.state]), [[owner, "APPROVED"]], "the imported approval is kept as history");
2852 assert.equal(p5.approvals, 0, "an imported approval does not count toward the required approvals");
2853 assert.equal(p5.required_approvals, 1);
2854 const p6 = await ok("GET", `/repos/${owner}/imported-app/pulls/6`);
2855 assert.equal(p6.head.ref, "forker:patch");
2856 assert.equal(p6.head.sha, fx.forkSha);
2857 assert.equal(p6.merged, false);
2858 // A pull request from a fork runs the fork's code, so its jobs get what GitHub gives them:
2859 // a read-only token and no secrets.
2860 assert.equal((await api("PUT", `/repos/${owner}/imported-app/actions/secrets/DEPLOY_KEY`, { value: "never-for-forks" })).status, 204);
2861 await ok("PATCH", `/repos/${owner}/imported-app/pulls/6`, { state: "open" });
2862 const forkJob = await until("the fork pull request's job", async () => {
2863 const r = await runnerClaim(`/repos/${owner}/imported-app`, ["linux"]);
2864 return r.status === 200 ? r.json : null;
2865 });
2866 const forkSpec = await (await fetch(`${base}/runner/jobs/${forkJob.job_id}`, { headers: { authorization: `Bearer ${forkJob.token}` } })).json();
2867 assert.equal(forkSpec.github.event_name, "pull_request");
2868 assert.deepEqual(Object.keys(forkSpec.secrets).sort(), ["DIFFINERY_TOKEN", "GITHUB_TOKEN"]);
2869 assert.equal((await api("POST", `/repos/${owner}/imported-app/issues`, { title: "from a fork's job" }, forkJob.token)).status, 403);
2870 await fetch(`${base}/runner/jobs/${forkJob.job_id}/complete`, { method: "POST", headers: { authorization: `Bearer ${forkJob.token}`, "content-type": "application/json" }, body: JSON.stringify({ conclusion: "success", outputs: {} }) });
2871 await ok("PATCH", `/repos/${owner}/imported-app/pulls/6`, { state: "closed" });
2872 // New issues continue after the highest imported number.
2873 assert.equal((await ok("POST", `/repos/${owner}/imported-app/issues`, { title: "After import" })).number, 8);
2874 // Labels, milestones, protection, variables.
2875 const labels = await ok("GET", `/repos/${owner}/imported-app/labels`);
2876 {
2877 const bug = labels.find((l) => l.name === "bug");
2878 assert.deepEqual([bug.name, bug.color, bug.description], ["bug", "d73a4a", "Something isn't working"]);
2879 }
2880 const milestones = await ok("GET", `/repos/${owner}/imported-app/milestones?state=all`);
2881 assert.equal(milestones.length, 1);
2882 assert.equal(milestones[0].due_on, "2030-01-01T00:00:00Z");
2883 assert.equal(milestones[0].open_issues, 1);
2884 const protection = await ok("GET", `/repos/${owner}/imported-app/branches/main/protection`);
2885 assert.match(JSON.stringify(protection), /CI \/ build/);
2886 const vars = await ok("GET", `/repos/${owner}/imported-app/actions/variables`);
2887 assert.deepEqual(vars.variables.map((v) => [v.name, v.value]).sort(), [["DEPLOY_ENV", "staging"], ["REGION", "us"]]);
2888 assert.ok((await ok("GET", "/diffinery/imports")).some((x) => x.id === started.id));
2889
2890 // ------------------------------------------------------------ secrets policy "stop" fails with a clear message
2891 const strict = await ok("POST", "/diffinery/imports", { source: "octo/app", owner, name: "strict-app", github_token: GH_TOKEN, github_api_url: apiUrl, options: { secrets: "stop", issues: false } });
2892 const strictAgent = await transfer(strict.id);
2893 assert.equal(strictAgent.status, 1, strictAgent.out);
2894 assert.match(strictAgent.out, /secret/i);
2895 const strictDone = await finished(strict.id);
2896 assert.equal(strictDone.status, "failed");
2897 assert.match(strictDone.error, /secrets/);
2898
2899 // ------------------------------------------------------------ a whole organization, into an organization
2900 await ok("POST", "/user/orgs", { login: "acme-imports" });
2901 const bulk = await ok("POST", "/diffinery/imports", { source_owner: "octo", owner: "acme-imports", github_token: GH_TOKEN, github_api_url: apiUrl, concurrency: 2, options: { lfs: false } });
2902 assert.equal(bulk.kind, "organization");
2903 assert.deepEqual(bulk.children.map((ch) => ch.source).sort(), ["octo/app", "octo/lib"]);
2904 for (const ch of bulk.children) assert.equal((await transfer(ch.id)).status, 0);
2905 const bulkDone = await finished(bulk.id, 300_000);
2906 assert.equal(bulkDone.status, "succeeded", JSON.stringify(bulkDone, null, 2));
2907 assert.deepEqual(bulkDone.summary.orgSecretNames, ["ORG_DEPLOY_KEY"]);
2908 const orgVars = await ok("GET", "/orgs/acme-imports/actions/variables");
2909 assert.deepEqual(orgVars.variables.map((v) => [v.name, v.value]), [["ORG_REGION", "eu-west"]]);
2910 assert.ok(bulkDone.warnings.some((w) => /ORG_PRIVATE_HOST/.test(w)) && bulkDone.warnings.some((w) => /ORG_SELECTED_KEY/.test(w)), JSON.stringify(bulkDone.warnings));
2911 assert.equal((await ok("GET", "/repos/acme-imports/lib")).default_branch, "trunk");
2912 assert.equal((await ok("GET", "/repos/acme-imports/lib/issues/1")).title, "Lib issue");
2913 assert.equal((await ok("GET", "/repos/acme-imports/app/pulls/2")).merged, true);
2914
2915 // ------------------------------------------------------------ without a token: everything public comes across, variables are skipped
2916 // GitHub answers Actions variables, secrets and environments only with a token (401 otherwise).
2917 const anon = await ok("POST", "/diffinery/imports", { source: "octo/lib", owner, name: "anon-lib", github_api_url: apiUrl, options: { lfs: false } });
2918 assert.equal((await transfer(anon.id)).status, 0);
2919 const anonDone = await finished(anon.id);
2920 assert.equal(anonDone.status, "succeeded", JSON.stringify(anonDone, null, 2));
2921 const anonVars = anonDone.steps.find((st) => st.name === "variables");
2922 assert.equal(anonVars.status, "skipped", JSON.stringify(anonDone.steps));
2923 assert.match(anonVars.message, /needs a GitHub token/);
2924 assert.ok(anonDone.warnings.some((w) => /variables, secret names and environments were not imported/.test(w)), JSON.stringify(anonDone.warnings));
2925 assert.equal((await ok("GET", `/repos/${owner}/anon-lib/issues/1`)).title, "Lib issue");
2926 assert.equal((await ok("GET", `/repos/${owner}/anon-lib`)).default_branch, "trunk");
2927
2928 // ------------------------------------------------------------ an agent's organization import cannot touch variables (H1)
2929 const agentBulk = await api("POST", "/diffinery/imports", { source_owner: "octo", owner: "acme-imports", github_token: GH_TOKEN, github_api_url: apiUrl, concurrency: 1, options: { lfs: false } }, bot);
2930 assert.equal(agentBulk.status, 201, JSON.stringify(agentBulk.json));
2931 const agentBulkDone = await finished(agentBulk.json.id, 180_000);
2932 const orgStep = agentBulkDone.steps.find((s) => s.name === "organization");
2933 assert.equal(orgStep.status, "skipped", JSON.stringify(agentBulkDone.steps));
2934 assert.match(orgStep.message, /agents cannot manage variables/);
2935 // The organization's variable is untouched by the agent import.
2936 assert.deepEqual((await ok("GET", "/orgs/acme-imports/actions/variables")).variables.map((v) => v.name), ["ORG_REGION"]);
2937
2938 // ------------------------------------------------------------ a retry onto a repository adopted since is refused (H2)
2939 await ok("POST", `/repos/${owner}/strict-app/issues`, { title: "adopted after the failed import" });
2940 await ok("POST", `/diffinery/imports/${strict.id}/retry`, { github_token: GH_TOKEN });
2941 const reDone = await finished(strict.id);
2942 assert.equal(reDone.status, "failed");
2943 assert.match(reDone.error, /holds content|start a new import/);
2944
2945 // ------------------------------------------------------------ a stale (revoked) import push token cannot push in import mode (M4)
2946 const stalePush = gitFails(copy, ["push", `${base}/${owner}/imported-app.git`, "--push-option=diffinery-import", "refs/heads/main:refs/heads/stale-attempt"], agent.pushToken);
2947 assert.match(stalePush, /401|403|denied|forbidden|authentication|fatal/i, stalePush);
2948
2949 // ------------------------------------------------------------ an organization import holds each repository to the size limit
2950 listHuge = true;
2951 const hugeBulk = await ok("POST", "/diffinery/imports", { source_owner: "octo", repositories: ["huge"], owner: "acme-imports", github_token: GH_TOKEN, github_api_url: apiUrl, concurrency: 1, options: { lfs: false } });
2952 const hugeChild = await until("the oversized repository to be refused", async () => {
2953 const ch = (await ok("GET", `/diffinery/imports/${hugeBulk.id}`)).children?.find((c) => c.source === "octo/huge");
2954 return ch?.status === "failed" ? ch : ch?.git?.phase === "waiting" ? Promise.reject(new Error("the oversized repository was queued for transfer")) : null;
2955 }, 120_000);
2956 assert.match(hugeChild.error ?? (await ok("GET", `/diffinery/imports/${hugeChild.id}`)).error, /import limit/);
2957 assert.equal((await api("GET", "/repos/acme-imports/huge")).status, 404);
2958 await finished(hugeBulk.id);
2959
2960 // ------------------------------------------------------------ the web UI (signed in via DEV_AUTH)
2961 for (const path of ["/new/import", "/imports", `/imports/${started.id}`, `/imports/${started.id}/secrets`, `/imports/${bulk.id}`, "/settings/linked-accounts", `/${owner}/imported-app/issues/1`, `/${owner}/imported-app/pull/2`]) {
2962 const res = await fetch(`${base}${path}`);
2963 const html = await res.text();
2964 assert.equal(res.status, 200, `${path} -> ${res.status}\n${html.slice(0, 500)}`);
2965 assert.ok(!/<select|type="checkbox"|type="radio"/.test(html.replace(/<template[\s\S]*?<\/template>/g, "")) || path.startsWith(`/${owner}`), `${path} renders Kumo controls, not native ones`);
2966 }
2967 assert.match(await (await fetch(`${base}/imports/${started.id}`)).text(), /NPM_TOKEN/);
2968 assert.match(await (await fetch(`${base}/${owner}/imported-app/issues/1`)).text(), /v1/);
2969 assert.match(await (await fetch(`${base}/${owner}/imported-app/issues/3`)).text(), /alice/);
2970 await gh.close();
2971});
2972
2973test("scheduled workflows: the schedule fires without a cron trigger", async () => {
2974 assert.ok(tickRepo, "the schedule was registered");
2975 const runs = await until("a scheduled run", async () => {
2976 const r = await ok("GET", `/repos/${tickRepo}/actions/runs?event=schedule`);
2977 return r.total_count > 0 && r.workflow_runs;
2978 }, 150_000);
2979 assert.equal(runs[0].event, "schedule");
2980 assert.equal(runs[0].path, ".github/workflows/tick.yml");
2981 assert.equal(runs[0].actor.login, "diffinery-scheduler");
2982 // One run per tick, never two for the same minute.
2983 const minutes = runs.map((r) => r.created_at.slice(0, 16));
2984 assert.equal(new Set(minutes).size, minutes.length, `two runs in one tick: ${minutes.join(", ")}`);
2985 // Site admins can see the scheduler's state (the live test reports it when no run comes).
2986 const state = await ok("GET", "/diffinery/admin/scheduler");
2987 assert.equal(state.tick_minutes, 1);
2988 assert.ok(state.last_tick_at && state.covered_until, JSON.stringify(state));
2989 assert.ok(Date.parse(state.next_tick_at) > Date.parse(state.last_tick_at), JSON.stringify(state));
2990 // And the newest unexpected server errors; a request id that isn't kept is a 404.
2991 const errors = await ok("GET", "/diffinery/admin/errors?per_page=5");
2992 assert.ok(Array.isArray(errors) && errors.length <= 5, JSON.stringify(errors));
2993 assert.equal((await api("GET", "/diffinery/admin/errors/not-a-request-id")).status, 404);
2994 // IndexNow is off on a local origin; its page and API still answer for site admins.
2995 const indexnow = await ok("GET", "/diffinery/admin/indexnow");
2996 assert.equal(indexnow.enabled, false, JSON.stringify(indexnow));
2997 assert.match(indexnow.off_reason, /public https/);
2998 assert.match(await (await fetch(`${base}/settings/admin/search-engines`)).text(), /Search engines[\s\S]*PUBLIC_URL isn/);
2999 assert.equal((await ok("GET", "/meta")).indexnow.enabled, false);
3000 // A push without the schedule removes it.
3001 const src = join(work, "schedules");
3002 rmSync(join(src, ".github/workflows/tick.yml"));
3003 git(src, ["commit", "-q", "-am", "no schedule"]);
3004 git(src, ["push", "-q", `${base}/${tickRepo}.git`, "main"]);
3005});
3006
3007/**
3008 * `git` without blocking this process, so the tests below run side by side; it rejects with git's
3009 * output and, on a server error or after 10 minutes without finishing (the command is killed, so a
3010 * stuck push fails the test instead of the whole job), the tail of `log` and what `more` says.
3011 * A `tok` of null sends no credentials (for GitHub).
3012 */
3013function gitAsync(cwd, args, tok = token, log = devLog, more = () => "") {
3014 const auth = tok === null ? [] : ["-c", `http.extraHeader=Authorization: Basic ${Buffer.from(`x-token:${tok}`).toString("base64")}`];
3015 return new Promise((done, fail) => {
3016 const child = spawn("git", [...auth, "-c", "protocol.version=2", ...args], {
3017 cwd,
3018 stdio: ["ignore", "pipe", "pipe"],
3019 env: { ...process.env, GIT_TERMINAL_PROMPT: "0", GIT_AUTHOR_NAME: "E2E", GIT_AUTHOR_EMAIL: "e2e@example.com", GIT_COMMITTER_NAME: "E2E", GIT_COMMITTER_EMAIL: "e2e@example.com" },
3020 });
3021 let stdout = "";
3022 let stderr = "";
3023 let timedOut = false;
3024 const timer = setTimeout(() => {
3025 timedOut = true;
3026 child.kill("SIGKILL");
3027 }, 600_000);
3028 child.stdout.on("data", (d) => (stdout += d));
3029 child.stderr.on("data", (d) => (stderr += d));
3030 child.on("error", fail);
3031 child.on("close", (status) => {
3032 clearTimeout(timer);
3033 if (status === 0) return done(stdout);
3034 let message = `git ${args.join(" ")} ${timedOut ? "didn't finish in 10 minutes" : `exited ${status}`}\n${stderr}`;
3035 if (timedOut || /HTTP 5\d\d|Failed to connect/.test(stderr)) message += `\n${more()}\n--- wrangler log tail ---\n${log().slice(-4000)}`;
3036 fail(Object.assign(new Error(message), { stdout, stderr }));
3037 });
3038 });
3039}
3040
3041/**
3042 * `ok`, `git` and `gitFails` against `server` (startServer's, or the shared one), with git that doesn't
3043 * block this process: for the tests below that run side by side.
3044 */
3045function client(server) {
3046 const ok = async (method, path, body) => {
3047 const send = () => fetch(`${server.base}/api/v3${path}`, { method, headers: { authorization: `Bearer ${server.token}`, "content-type": "application/json" }, body: body === undefined ? undefined : JSON.stringify(body) });
3048 // A GET goes again on a kept-alive connection the server closed meanwhile, as in api().
3049 const r = await send().catch((e) => (method === "GET" ? sleep(1000).then(send) : Promise.reject(e)));
3050 const text = await r.text();
3051 assert.ok(r.ok, `${method} ${path} -> ${r.status} ${text}`);
3052 return JSON.parse(text);
3053 };
3054 const git = (cwd, args) => gitAsync(cwd, args, server.token, server.log, () => `the Worker was at ${server.direct}; wrangler dev now names ${server.workerUrl?.() ?? "(the shared server)"}`);
3055 const gitFails = async (cwd, args) => {
3056 try {
3057 await git(cwd, args);
3058 } catch (e) {
3059 return `${e.stdout ?? ""}${e.stderr ?? ""}`;
3060 }
3061 assert.fail(`expected git ${args.join(" ")} to fail`);
3062 };
3063 // Git goes straight to the Worker: wrangler dev's own proxy drops large pushes and clones streaming
3064 // through it (see workerUrl), which isn't Diffinery and doesn't exist in production.
3065 assert.ok(server.direct, `the Worker's own address wasn't found in wrangler dev's debug log`);
3066 return { ...server, gitBase: server.direct, ok, git, gitFails };
3067}
3068const shared = () => client({ base, direct, token, log: devLog });
3069
3070/** Runs `fn` with a client of a server of its own, stopped afterwards. */
3071async function onOwnServer(name, fn, ready = Promise.resolve()) {
3072 const [server] = await Promise.all([startServer(name), ready]);
3073 try {
3074 assert.ok(server.direct && (await fetch(`${server.direct}/healthz`)).ok, `the Worker's own address (${server.direct}) doesn't answer`);
3075 return await fn(client(server));
3076 } finally {
3077 server.stop();
3078 }
3079}
3080
3081/**
3082 * A real project's history, pushed whole to a new repository on `server` and cloned back. Pinned
3083 * commits, so the packs are the same each run; cloned from GitHub without the Diffinery token.
3084 */
3085async function pushHistory({ gitBase, ok, git }, name, upstream) {
3086 const me = await ok("GET", "/user");
3087 await ok("POST", "/user/repos", { name });
3088 const remote = `${gitBase}/${me.login}/${name}.git`;
3089 // Test fixtures in these histories look like credentials (tornado has a test private key): pushed as an admin's bypass.
3090 await git(upstream, ["-c", "http.postBuffer=1048576", "push", "-q", "-o", "allow-secrets=e2e of a public history", remote, "main"]);
3091 const out = join(work, `${name}-clone`);
3092 await git(work, ["clone", "-q", "--bare", remote, out]);
3093 assert.equal((await git(out, ["rev-parse", "main"])).trim(), (await git(upstream, ["rev-parse", "main"])).trim());
3094 assert.equal((await git(out, ["rev-list", "--count", "main"])).trim(), (await git(upstream, ["rev-list", "--count", "main"])).trim());
3095 await git(out, ["fsck", "--full"]);
3096}
3097
3098// Two at a time, each on a server of its own (the lockfile's on the shared one): one big push keeps
3099// one server process busy, so on separate processes they use the runner's other cores; jquery's push
3100// takes about as long as the other three's together. Not all four: a local server's memory grows to
3101// 2 to 4 GB during such a push, and four at once ran a runner out of memory (the Workers runtime
3102// crashed mid-push); two at a time peak about 1 GB above one at a time. Git goes past wrangler dev's
3103// proxy (see client).
3104describe("real histories: whole projects, side by side", { concurrency: 2 }, () => {
3105 for (const [name, url, sha] of [
3106 // 37 MB: staged in R2 and unpacked in pieces.
3107 ["jquery", "https://github.com/jquery/jquery", "c2f27864e4ffc2d1409c289fcb9a42b6165dfeaf"],
3108 // About 12 MB each: too many objects for parsing whole in memory, so unpacked in pieces too.
3109 ["tornado", "https://github.com/tornadoweb/tornado", "056cacaefc7de31bda28363378c4ffc86b97d7e4"],
3110 ["flask", "https://github.com/pallets/flask", "d086db856be187255b8ec61ef409357393020f32"],
3111 ]) {
3112 test(`real histories: ${name}'s whole history goes in one push and clones back intact`, async () => {
3113 const upstream = join(work, `${name}-upstream.git`);
3114 const download = gitAsync(work, ["clone", "-q", "--bare", "--no-tags", url, upstream], null).then(() => gitAsync(upstream, ["update-ref", "refs/heads/main", sha], null));
3115 await onOwnServer(name, (c) => pushHistory(c, name, upstream), download);
3116 });
3117 }
3118
3119 test("real histories: a 2.6 MB lockfile's 60 versions, a chain of deltas, go in one small push", async () => {
3120 const upstream = join(work, "lockfile-upstream");
3121 mkdirSync(upstream, { recursive: true });
3122 git(upstream, ["init", "-q", "-b", "main"]);
3123 const versions = new Map();
3124 const pkgs = Array.from({ length: 11_000 }, (_, i) => `pkg-${String(i).padStart(5, "0")}`);
3125 pkgs.forEach((p, i) => versions.set(p, `1.${i % 51}.${i % 97}`));
3126 for (let c = 0; c < 60; c++) {
3127 for (let k = 0; k < 40; k++) versions.set(pkgs[(c * 7919 + k * 104729) % pkgs.length], `2.${c}.${k}`);
3128 const body = pkgs.map((p) => {
3129 const v = versions.get(p);
3130 return ` "node_modules/${p}": {\n "version": "${v}",\n "resolved": "https://registry.npmjs.org/${p}/-/${p}-${v}.tgz",\n "integrity": "sha512-${createHash("sha512").update(p + v).digest("hex").slice(0, 64)}"\n },\n`;
3131 });
3132 writeFileSync(join(upstream, "package-lock.json"), `{\n "lockfileVersion": 3,\n "packages": {\n${body.join("")} }\n}\n`);
3133 git(upstream, ["add", "-A"]);
3134 git(upstream, ["commit", "-q", "-m", `lockfile ${c}`]);
3135 }
3136 assert.ok(readFileSync(join(upstream, "package-lock.json")).length > 2_500_000);
3137 const packBytes = Number(execFileSync("bash", ["-c", "git pack-objects --revs --stdout -q <<<main | wc -c"], { cwd: upstream, encoding: "utf8" }).trim());
3138 assert.ok(packBytes < 16 * 1024 * 1024, `the pack is ${packBytes} bytes`);
3139 await pushHistory(shared(), "lockfile", upstream);
3140 });
3141});
3142
3143// Side by side, each on a server of its own, as the real histories above: about as long as the 40 MB
3144// history's pushes alone instead of the sum.
3145describe("large pushes: side by side, each on a server of its own", { concurrency: true }, () => {
3146 test("large files: a 40 MB file is pushed and cloned intact, and push protection still reads big text files", () =>
3147 onOwnServer("bigfile", async ({ gitBase, ok, git, gitFails }) => {
3148 const me = await ok("GET", "/user");
3149 await ok("POST", "/user/repos", { name: "bigfile" });
3150 const src = join(work, "bigfile");
3151 mkdirSync(src, { recursive: true });
3152 await git(src, ["init", "-q", "-b", "main"]);
3153 // Random bytes don't compress: the push is over 16 MB, so it goes through R2 on its way in.
3154 const data = randomBytes(40 * 1024 * 1024);
3155 writeFileSync(join(src, "big.bin"), data);
3156 await git(src, ["add", "-A"]);
3157 await git(src, ["commit", "-q", "-m", "a large file"]);
3158 await git(src, ["-c", "http.postBuffer=1048576", "push", "-q", `${gitBase}/${me.login}/bigfile.git`, "main"]);
3159 const out = join(work, "bigfile-clone");
3160 await git(work, ["clone", "-q", `${gitBase}/${me.login}/bigfile.git`, out]);
3161 assert.ok(readFileSync(join(out, "big.bin")).equals(data), "the cloned file is the pushed file");
3162 const wantBlob = (await git(src, ["rev-parse", "HEAD:big.bin"])).trim();
3163 assert.equal((await git(out, ["rev-parse", "HEAD:big.bin"])).trim(), wantBlob);
3164 // A large text file (scanned slice by slice) with a key near its end is still refused.
3165 // diffinery:allow-secret (a fake key)
3166 writeFileSync(join(src, "dump.sql"), `${"-- row\n".repeat(1024 * 1024)}aws_key = AKIAIOSFODNN7EXAMPL3\n`);
3167 await git(src, ["add", "-A"]);
3168 await git(src, ["commit", "-q", "-m", "a large dump"]);
3169 assert.match(await gitFails(src, ["push", "-q", `${gitBase}/${me.login}/bigfile.git`, "main"]), /possible secrets detected/);
3170 }));
3171
3172 test("large pushes: three large pushes into one repository at once all go in, and a fetch meanwhile works", () =>
3173 onOwnServer("pushes-at-once", async ({ gitBase, ok, git }) => {
3174 const me = await ok("GET", "/user");
3175 await ok("POST", "/user/repos", { name: "pushes-at-once" });
3176 const remote = `${gitBase}/${me.login}/pushes-at-once.git`;
3177 const src = join(work, "pushes-at-once");
3178 mkdirSync(src, { recursive: true });
3179 await git(src, ["init", "-q", "-b", "main"]);
3180 writeFileSync(join(src, "README.md"), "base\n");
3181 await git(src, ["add", "-A"]);
3182 await git(src, ["commit", "-q", "-m", "base"]);
3183 await git(src, ["push", "-q", remote, "main"]);
3184 // Each branch: many medium files over a few commits, so unpacking holds a lot. Two packs stay under
3185 // 16 MB (handed over in memory), one goes over (staged in R2), as when several agents push at once.
3186 const sizes = { a: 180, b: 180, c: 420 };
3187 const tips = {};
3188 for (const [branch, count] of Object.entries(sizes)) {
3189 await git(src, ["checkout", "-q", "-b", branch, "main"]);
3190 const files = Array.from({ length: count }, () => randomBytes(48 * 1024).toString("base64"));
3191 mkdirSync(join(src, branch), { recursive: true });
3192 for (let c = 0; c < 3; c++) {
3193 files.forEach((f, i) => writeFileSync(join(src, branch, `f${i}.txt`), `${f}\nrevision ${c}\n${randomBytes(1024).toString("hex")}\n`));
3194 await git(src, ["add", "-A"]);
3195 await git(src, ["commit", "-q", "-m", `${branch} ${c}`]);
3196 }
3197 tips[branch] = (await git(src, ["rev-parse", "HEAD"])).trim();
3198 }
3199 await git(src, ["checkout", "-q", "main"]);
3200 const push = (branch) => git(src, ["-c", "http.postBuffer=1048576", "push", "-q", remote, branch]);
3201 const fetchWhile = git(work, ["clone", "-q", remote, join(work, "pushes-at-once-early")]);
3202 await Promise.all([push("a"), push("b"), push("c"), fetchWhile]);
3203 const branches = (await ok("GET", `/repos/${me.login}/pushes-at-once/branches`)).map((b) => b.name).sort();
3204 assert.deepEqual(branches, ["a", "b", "c", "main"]);
3205 const out = join(work, "pushes-at-once-clone");
3206 await git(work, ["clone", "-q", "--mirror", remote, out]);
3207 for (const [branch, tip] of Object.entries(tips)) assert.equal((await git(out, ["rev-parse", `refs/heads/${branch}`])).trim(), tip);
3208 await git(out, ["fsck", "--full", "--strict"]);
3209 }));
3210
3211 test("large pushes: a 40 MB history of many files goes in one push, read from R2 in ranges, and is still checked", () =>
3212 onOwnServer("bighistory", async ({ gitBase, ok, git, gitFails }) => {
3213 const me = await ok("GET", "/user");
3214 await ok("POST", "/user/repos", { name: "bighistory" });
3215 const remote = `${gitBase}/${me.login}/bighistory.git`;
3216 const src = join(work, "bighistory");
3217 mkdirSync(join(src, "files"), { recursive: true });
3218 await git(src, ["init", "-q", "-b", "main"]);
3219 // Hundreds of medium files, each changed a little in later commits: a pack of deltas over 16 MB,
3220 // as a fork's pull request heads made one in jekyll/minima's import.
3221 const files = Array.from({ length: 400 }, () => randomBytes(96 * 1024).toString("base64"));
3222 for (let c = 0; c < 6; c++) {
3223 files.forEach((f, i) => writeFileSync(join(src, "files", `f${i}.txt`), `${f}\nrevision ${c} of file ${i}\n${randomBytes(2048).toString("hex")}\n`));
3224 await git(src, ["add", "-A"]);
3225 await git(src, ["commit", "-q", "-m", `revision ${c}`]);
3226 }
3227 const packBytes = Number(execFileSync("bash", ["-c", "git pack-objects --revs --stdout -q <<<main | wc -c"], { cwd: src, encoding: "utf8" }).trim());
3228 assert.ok(packBytes > 30 * 1024 * 1024, `the pack is ${packBytes} bytes`);
3229 await git(src, ["-c", "http.postBuffer=1048576", "push", "-q", remote, "main"]);
3230 const out = join(work, "bighistory-clone");
3231 await git(work, ["clone", "-q", remote, out]);
3232 assert.equal((await git(out, ["rev-parse", "HEAD"])).trim(), (await git(src, ["rev-parse", "HEAD"])).trim());
3233 await git(out, ["fsck", "--full", "--strict"]);
3234
3235 // A second large push builds on objects the repository has (a thin pack, its bases read from storage).
3236 files.forEach((f, i) => writeFileSync(join(src, "files", `f${i}.txt`), `${f}\nrevision 6 of file ${i}\n${randomBytes(2048).toString("hex")}\n`));
3237 writeFileSync(join(src, "new.bin"), randomBytes(20 * 1024 * 1024));
3238 await git(src, ["add", "-A"]);
3239 await git(src, ["commit", "-q", "-m", "revision 6"]);
3240 await git(src, ["-c", "http.postBuffer=1048576", "push", "-q", remote, "main"]);
3241 await git(out, ["pull", "-q", "--ff-only"]);
3242 assert.equal((await git(out, ["rev-parse", "HEAD"])).trim(), (await git(src, ["rev-parse", "HEAD"])).trim());
3243 await git(out, ["fsck", "--full", "--strict"]);
3244
3245 // A large push is checked like a small one: a key in one small file, or an unsafe .gitmodules, refuses all of it.
3246 await git(src, ["checkout", "-q", "-b", "leak"]);
3247 writeFileSync(join(src, "more.bin"), randomBytes(20 * 1024 * 1024));
3248 writeFileSync(join(src, "config.txt"), "aws_key = AKIAIOSFODNN7EXAMPL3\n"); // diffinery:allow-secret (a fake key; the pushed file doesn't carry the marker)
3249 await git(src, ["add", "-A"]);
3250 await git(src, ["commit", "-q", "-m", "a key"]);
3251 assert.match(await gitFails(src, ["-c", "http.postBuffer=1048576", "push", "-q", remote, "leak"]), /possible secrets detected/);
3252 await git(src, ["checkout", "-q", "main"]);
3253 await git(src, ["checkout", "-q", "-b", "modules"]);
3254 writeFileSync(join(src, "more.bin"), randomBytes(20 * 1024 * 1024));
3255 writeFileSync(join(src, ".gitmodules"), '[submodule "x"]\n\tpath = x\n\turl = --upload-pack=touch /tmp/pwned\n');
3256 await git(src, ["add", "-A"]);
3257 await git(src, ["commit", "-q", "-m", "an unsafe submodule"]);
3258 assert.match(await gitFails(src, ["-c", "http.postBuffer=1048576", "push", "-q", remote, "modules"]), /fsck error: \.gitmodules .*starts with '-'/);
3259 const branches = (await ok("GET", `/repos/${me.login}/bighistory/branches`)).map((b) => b.name);
3260 assert.deepEqual(branches, ["main"]);
3261 }));
3262});