Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
238 commits
Select commit Hold shift + click to select a range
ad398b4
fork: the server and CLI update from the desktop app's repository (#1)
scuttletoby Nov 12, 2026
3556ac6
fork: release workflow for v<upstream>-fork.N on GitHub-hosted runner…
scuttletoby Nov 12, 2026
8669d86
fork: fast CI on GitHub-hosted runners (fork-tests.yml) (#6)
scuttletoby Nov 12, 2026
a4cc0fe
fork: CI check that refuses database schema and migration changes (#3)
scuttletoby Nov 12, 2026
3303264
fork: green main again (schema-check comments, checkout without submo…
scuttletoby Nov 12, 2026
2fd0daa
fork: follow each stable upstream release with the patch series (#4)
scuttletoby Nov 12, 2026
2b08c2f
fork: outside PRs run nothing, one checkout without actions/checkout,…
scuttletoby Nov 12, 2026
1603502
fork: delete four outside-started upstream workflows and keep them de…
scuttletoby Nov 12, 2026
316b6e6
fork: follow upstream's newest nightly tag (FORK_FOLLOW_CHANNEL, defa…
scuttletoby Nov 13, 2026
3ced2aa
feat(web): file links open remotely, full size, download from their m…
scuttletoby Nov 13, 2026
702205f
fork-ci: docs-scope composite action (docs-only gate and per-job path…
scuttletoby Nov 13, 2026
ed5804a
fork-ci: gradle-cache composite action (locked Maven local repository…
scuttletoby Nov 13, 2026
8ab47ea
fork: the fork-follow test's fake gh no longer reads as a real workfl…
scuttletoby Nov 14, 2026
2bf3e12
fork: Fork tests on the repository's own fleet runners, chosen per ru…
scuttletoby Nov 14, 2026
429b6f0
fork-ci: job-changed composite action (did this workflow job's inputs…
scuttletoby Nov 14, 2026
ad440e3
fork-ci pr-queue 1/4: lens review rules and a strict config (#18)
scuttletoby Nov 14, 2026
b5bd839
fork-ci pr-queue 2/4: the queue's merge path (pr_queue.py) (#19)
scuttletoby Nov 14, 2026
d36afe3
fork-ci pr-queue 3/4: armed pull requests that cannot merge are told …
scuttletoby Nov 14, 2026
1db6c90
fork-ci pr-queue 4/4: update a PR that was red only because its base …
scuttletoby Nov 14, 2026
81237f0
docs(fork): host tools design: agents on a person's own computer (lim…
scuttletoby Nov 14, 2026
90eb039
fork-ci pr-queue: leftover minors from the stack reviews (#32)
scuttletoby Nov 14, 2026
4f49d69
Fork: weekly check that the repository's interaction limit never laps…
scuttletoby Nov 14, 2026
f78cc23
Fork: head-check action, the queue's required head check with lens.py…
scuttletoby Nov 14, 2026
bf85d37
fork-ci: release commits that hold only fork-ci, protected tags (#35)
scuttletoby Nov 14, 2026
24c932f
feat(server): keep a history of provider usage-limit readings (#24)
scuttletoby Nov 14, 2026
1b3ee8b
fork: document the anchor machine as load-balancing weights; old sett…
scuttletoby Nov 14, 2026
5ab50c6
feat(server): refresh usage limits while no client watches (usage pac…
scuttletoby Nov 14, 2026
4e774f2
Auto-update (server): background service updates itself when quiet (#5)
scuttletoby Nov 14, 2026
a666cd0
fork-fleet: route for any repository (hosted:false, static pools, per…
scuttletoby Nov 14, 2026
404d2b7
fork-ci: fleet-route action and a usage guide for every action (#55)
scuttletoby Nov 14, 2026
9d34731
fork-ci: read reviews' edit and hidden flags with our own query (#56)…
scuttletoby Nov 14, 2026
f8411b2
fork-follow: grant actions: write to the release call; test called-wo…
scuttletoby Nov 14, 2026
70188a5
feat(usage): UsagePacer, pace per provider instance and window (pacin…
scuttletoby Nov 14, 2026
3f6a511
fork: delete upstream's issue-vouch.yml and keep it deleted
scuttletoby Nov 14, 2026
2b29d37
fork-tests: follow upstream's test jobs at v0.1.10-nightly.20261114.4669
scuttletoby Nov 14, 2026
ac9e244
docs(fork-fleet): name no machine ids in the public docs (#74)
scuttletoby Nov 14, 2026
5ebdf73
pr-queue lens: clean_inline keeps the source's answers in linear time…
scuttletoby Nov 14, 2026
d4a6682
fix(pr-queue): wait out the queued-check race, tell a conflicted PR, …
scuttletoby Nov 14, 2026
88e5235
feat(usage): usage pacing gate on delegate_task (pacing part 4) (#73)
scuttletoby Nov 14, 2026
5ea575c
fix(secret-scan): skip upstream's commits in push ranges (#75)
scuttletoby Nov 14, 2026
de99883
feat(waits): contracts and pure functions for wait_for and agent slot…
scuttletoby Nov 14, 2026
f3e89fa
feat(slots): agent slot gate on delegate_task (off by default) (#89)
scuttletoby Nov 14, 2026
6669f31
fork-kit/gh-apps: host install kit for GitHub App tokens (gate-trust …
scuttletoby Nov 14, 2026
8c92bc6
feat(waits): wait store and service (off, not wired) (#90)
scuttletoby Nov 14, 2026
b777434
fork-ci: head gate, the head check as a gate App's check run (#34) (#85)
scuttletoby Nov 14, 2026
d3dc9cd
docs(fork): gate trust, what the head gate proves and the owner's ste…
scuttletoby Nov 14, 2026
8142691
fork-ci: Python API for docs-scope, a no_build key, and pinned (run f…
scuttletoby Nov 14, 2026
f322e50
feat(waits): delivery and scheduling (part 3, off by default) (#91)
scuttletoby Nov 14, 2026
56efcb1
fork-checks: refuse fork changes to upstream's Orchestrator.ts and ag…
scuttletoby Nov 14, 2026
08605bc
Add settings UI for agent waits, wait checks and agent slots (waitfor…
scuttletoby Nov 14, 2026
c8620b3
feat(waits): agent tools to register, list and cancel waits (part 4, …
scuttletoby Nov 14, 2026
f0c72d0
feat(waits): check and unit judges, outage wake cap (part 5, off by d…
scuttletoby Nov 15, 2026
0cb5f90
feat(waits): the pr judge (part 6, off by default) (#109)
scuttletoby Nov 15, 2026
1f62fa2
Fork (waits PR 8): slot waits, woken when an agent slot frees (#110)
scuttletoby Nov 15, 2026
2800477
fix(waits): pin pr wait targets, re-look a timed-out remote, keep slo…
scuttletoby Nov 15, 2026
ec81dca
fork-ci: ci-demand, a read-only CI demand measure (#113)
scuttletoby Nov 15, 2026
a1a28df
fix(waits): monotonic judge deadlines, early messages, hidden-hold co…
scuttletoby Nov 15, 2026
102eb10
fork-ci: ci-demand follow-ups (cache write failure shown, BOM, NaN da…
scuttletoby Nov 15, 2026
ca8ee17
fork: read-only report command (go-live kit PR 2) (#172)
scuttletoby Nov 15, 2026
154d18c
Fork default pin: one row per fork setting, #51 fix, #44 test, sync r…
scuttletoby Nov 15, 2026
ede5a26
fork-kit: heavy stops what its command leaves behind (#173)
scuttletoby Nov 15, 2026
bf89386
fork report: follow a symlinked DB and warn on an empty settings file…
scuttletoby Nov 15, 2026
a9c5db4
fork: delegate checks behind one fork module (SEAM) (#174)
scuttletoby Nov 15, 2026
f8fdd6c
fork settings: fork keys live in forkSettings.ts (FS0) (#185)
scuttletoby Nov 15, 2026
9222c7a
fork: serve --hold-work (go-live kit PR 1) (#175)
scuttletoby Nov 15, 2026
91213ef
fork-kit: heavy sweep finds what escaped heavy; common machine-file l…
scuttletoby Nov 15, 2026
685baf1
fork-kit/golive: kit core (config, lock and journal, live T3, check, …
scuttletoby Nov 15, 2026
996d395
fork fleet: desk link, always-on side (D2) (#192)
scuttletoby Nov 15, 2026
80b5eb7
fork fleet: desk link key tool (D4) (#195)
scuttletoby Nov 15, 2026
a06854c
dynamic slots: capacity rule, shared vectors, pure evaluator (DS1) (#…
scuttletoby Nov 15, 2026
e81f679
fork fleet: launcher walls for every pool (D1) (#191)
scuttletoby Nov 15, 2026
f9a0324
Secret scan: merges with hand-resolved conflicts no longer fail the s…
scuttletoby Nov 15, 2026
4301d3c
fork fleet: per-OS walls layer (D5) (#194)
scuttletoby Nov 15, 2026
11e5f02
fork fleet: walls proof for a new kind of host (stacked on #191) (#198)
scuttletoby Nov 15, 2026
22e271e
fork fleet: desk link, desktop side (D3) (#205)
scuttletoby Nov 15, 2026
e6438cc
fork fleet: runner template refresh + daily timer (D7) (#196)
scuttletoby Nov 15, 2026
06f5e55
Secret scan: settings from the default branch, fail on octopus merges…
scuttletoby Nov 15, 2026
863924a
fork-fleet: walls re-check minors (#191, #194, #198) (#208)
scuttletoby Nov 15, 2026
fc34d2c
fork fleet: WSL2 walls (D6) (#197)
scuttletoby Nov 15, 2026
395faa8
Secret scan: repository settings, binary and UTF-16 contents, squash-…
scuttletoby Nov 15, 2026
67d4a8a
Secret scanning: GitHub's scanner skips .gitleaks.toml (#216)
scuttletoby Nov 15, 2026
6768a78
docs(fork): list fork changes and settings, pinned to the defaults ta…
scuttletoby Nov 15, 2026
13aed17
fleet walls: read units and every property form, one kit, root-owned …
scuttletoby Nov 15, 2026
a81d2aa
Secret scan: replaced heads, every push, main's script, exact-value a…
scuttletoby Nov 15, 2026
c9cf7eb
fork-ci fleet-route: a job may avoid a dispatcher pool for some kinds…
scuttletoby Nov 15, 2026
a92be6e
fork-ci fleet-route: a person's re-run of failed jobs may use a dispa…
scuttletoby Nov 15, 2026
3caeb9f
docs: a short block at the top of the README naming what the fork add…
scuttletoby Nov 15, 2026
f896ddc
MCP profiles 1: settings and the profile resolver (nothing calls it y…
scuttletoby Nov 16, 2026
59d603d
fleet walls: the seven #226 follow-ups (fail closed) (#240)
scuttletoby Nov 16, 2026
35de436
fork-ci: fleet-watch action (watch, sweep, pending) for runs a dispat…
scuttletoby Nov 16, 2026
54f534e
golive: kit copy (practice stop, cold copy, restore primitive) (#228)
scuttletoby Nov 16, 2026
abce4a0
fork fleet: desk setup pack kit (D8) (#225)
scuttletoby Nov 16, 2026
df24284
fork fleet: Windows starter for a desk pool (D9) (#229)
scuttletoby Nov 16, 2026
92f6e9c
fork fleet: free/v1 "is this machine free?" contract and examples (D1…
scuttletoby Nov 16, 2026
86a9b26
fork-kit: pc-agents walls and their check (part 1 of 2) (#232)
scuttletoby Nov 16, 2026
c7bf341
fork-kit: pc-agents setup, bootstrap and owner steps (part 2 of 2) (#…
scuttletoby Nov 16, 2026
e66532c
fork fleet: `seed` verb and `seeds` in the fleet config (D11) (#236)
scuttletoby Nov 16, 2026
84c55cc
Test Web: three shards, Chromium garbage collected after every file (…
scuttletoby Nov 16, 2026
5b161cb
Fork script tests: longest first, kit tests in their own job, secret-…
scuttletoby Nov 16, 2026
75643a6
pr-queue: never delete a merged branch with the token; stacked PRs st…
scuttletoby Nov 16, 2026
23436bf
fork-fleet-walls tests: the fixture contract in its own file (#252)
scuttletoby Nov 17, 2026
5c99cb5
Fork tests: a fork-only pull request skips the app jobs (#251)
scuttletoby Nov 17, 2026
3a32a97
pr-queue: read with the run's GITHUB_TOKEN, write with the PAT (#255)
scuttletoby Nov 17, 2026
72129fd
fork CI: warn when merged branches stay; test that nothing outside th…
scuttletoby Nov 17, 2026
1250711
fork-ci test-select: run only the test files a pull request's change …
scuttletoby Nov 17, 2026
2854cec
fork fleet: a desktop fetches its desk pool's seeds (D11b) (#237)
scuttletoby Nov 17, 2026
1e439a9
fork fleet: desk pool docs, a neutral example, the fork's pc pool on …
scuttletoby Nov 17, 2026
e4ae5e3
fork: playtest settings and adapter contract (server.playtest) (#260)
scuttletoby Nov 17, 2026
900a385
feat(playtest): session store and service (claim, rounds, release) (#…
scuttletoby Nov 17, 2026
fd5abae
fork-ci release: carry the files pc-agents setup copies (#263)
scuttletoby Nov 17, 2026
011777a
feat(playtest): worker: renew, idle and time limit, end with the thre…
scuttletoby Nov 17, 2026
b32057f
fork-kit: PC setup passes on a fresh WSL2 distro (container mark, T3 …
scuttletoby Nov 17, 2026
39eb4c4
pc-agents: policy names only settings every T3 knows; show T3's error…
scuttletoby Nov 17, 2026
337f8ac
fix(server): usage history misses no update during start-up (#60) (#272)
scuttletoby Nov 17, 2026
1e7ad52
pc-agents: start errors, pairing from the command line, setup notes (…
scuttletoby Nov 17, 2026
5760f4b
fork report: settings with comments, a file as data folder, no leftov…
scuttletoby Nov 17, 2026
6779da7
fleet + pr-queue: tests for the private check, waiting-pool order, re…
scuttletoby Nov 17, 2026
d5257ee
ci-demand: bad input files report a problem instead of crashing (#166…
scuttletoby Nov 17, 2026
f70a8e0
fix(server): fork report prints JSON for a home it cannot look at (#2…
scuttletoby Nov 17, 2026
c59446f
pc-agents: pair names a missing T3, packages Node needs, minimum T3; …
scuttletoby Nov 17, 2026
d3691cf
fleet units: own stop timeout, tested job walls (#217 #204) (#280)
scuttletoby Nov 17, 2026
32e4039
handoff: person-only setting and pure handoff decision (HO1) (#282)
scuttletoby Nov 17, 2026
b0f1bec
golive: report only beside a steady T3, counts report to report, rest…
scuttletoby Nov 17, 2026
20bc8a3
fix(pr-queue): lens opt-out blocks a read written another way; one-pa…
scuttletoby Nov 17, 2026
8d43c46
ci-demand: item-level cache damage, --json clean-up, date tests (#287…
scuttletoby Nov 17, 2026
f9ede96
dynamic slots: capacity readings: swap, pressure, live total, per-pie…
scuttletoby Nov 17, 2026
71cb445
contracts: reviewRules person-only setting and recommended preset (PK…
scuttletoby Nov 17, 2026
9339925
fix(fork-kit/heavy): sweep keeps kept containers and hides inline cod…
scuttletoby Nov 17, 2026
a186420
fork-ci: README startup block checks the cache folder before using it…
scuttletoby Nov 17, 2026
f218218
usage history: start-up drain replay not stored as a full read; test …
scuttletoby Nov 17, 2026
ae5b1a7
fleet: walls skip a job unit that just ended, stamp the lookup time, …
scuttletoby Nov 17, 2026
3713a23
fleet dispatcher: clean up offline registrations under a pool's retir…
scuttletoby Nov 17, 2026
fa6f6b1
pc-agents: prerelease below its release, packages after resolv.conf, …
scuttletoby Nov 17, 2026
3737aba
fork-ci pr-queue: parse and validate the `review` block (PK10 C1) (#301)
scuttletoby Nov 17, 2026
a1049da
fix(server): usage refresher skips healthy OpenCode like upstream; te…
scuttletoby Nov 17, 2026
6cb9ce1
secret scan: full rule id check, shallow refusal, alert de-dup, guard…
scuttletoby Nov 17, 2026
e3d0ed9
fork-ci pinned: follow-ups from #305 (cache race, import check spelli…
scuttletoby Nov 17, 2026
7f42f24
usage refresher: clear the failure streak on the healthy skip (#322) …
scuttletoby Nov 17, 2026
1b2e8ff
settings: Duration fields from one list; a bad saved interval falls b…
scuttletoby Nov 17, 2026
b09236e
usage refresher: end a failure streak only on a truly healthy skip (#…
scuttletoby Nov 17, 2026
86e98b6
fork-ci pinned: run folder in the cache, usual spellings, __cached__ …
scuttletoby Nov 17, 2026
d12f0cf
fleet dispatcher: follow-ups from #309 (old-label runners, label reus…
scuttletoby Nov 17, 2026
28ee8b0
usage refresher: pin the comeback retry delay and skip-guard checks (…
scuttletoby Nov 17, 2026
ddcfa03
fork-ci head-check: judge required lenses by changed path (PK10 C2) (…
scuttletoby Nov 17, 2026
e5dddf0
pc-agents: follow-ups from the #308 lens (#321) (#338)
scuttletoby Nov 17, 2026
85b51a2
heavy sweep: follow-ups from #289 round 2 (#312) (#328)
scuttletoby Nov 17, 2026
0310d4b
dynamic slots: slot gate observe mode, mode setting, old settings map…
scuttletoby Nov 17, 2026
f8c0254
settings: interval walk handles union-wrapped intervals; good-value t…
scuttletoby Nov 17, 2026
2e33c3a
fleet dispatcher: only stop old-label runners whose unit is here; cou…
scuttletoby Nov 17, 2026
9c1e04b
fork-kit: model-guard hook, model policy v0 (M0) (#275)
scuttletoby Nov 17, 2026
20c4f07
web: review rules settings panel with recommended preset button (PK10…
scuttletoby Nov 17, 2026
6ab1c9d
fork-ci pinned: check folders above the cache, more import spellings,…
scuttletoby Nov 17, 2026
6ad249f
fleet walls: launcher timeout read refuses what start() never passes;…
scuttletoby Nov 17, 2026
386dfb7
fleet dispatcher: stop only runners whose unit is here, both labels; …
scuttletoby Nov 17, 2026
e12a28a
hold-work: a held server does not start T3 Connect; tests for every h…
scuttletoby Nov 17, 2026
34b4894
heavy sweep: = words after env, -S depth cap, php -d and other option…
scuttletoby Nov 17, 2026
291429e
C2 path judge: non-UTF-8 names, config path spelling, rule order, wor…
scuttletoby Nov 17, 2026
433cdc3
fork seam check: every upstream file counted, allow list from main (#…
scuttletoby Nov 17, 2026
c76b5f5
fleet-route docs: two dispatchers on one pool race; table row; split …
scuttletoby Nov 17, 2026
5299b63
pinned: folder check in load(), doctest loader, clean refusal for an …
scuttletoby Nov 17, 2026
d33dc92
review rules panel: test the hook's failure labels and the clear-over…
scuttletoby Nov 17, 2026
1958d94
head gate: re-run after reviews and inline review comments via workfl…
scuttletoby Nov 17, 2026
2247cdc
fleet walls: jobs see an allow-list of /etc, not all of it (#243) (#360)
scuttletoby Nov 17, 2026
20e189c
pinned runner: #369 lens follow-ups (real folder named through symlin…
scuttletoby Nov 17, 2026
908e080
slots observe: one count per agent, stored held slots, seams list, te…
scuttletoby Nov 17, 2026
b858c03
fix(fork-ci): C2 path judge follow-ups from the #359 lenses (#374) (#…
scuttletoby Nov 17, 2026
c9b475b
fork-ci: report existing tests a PR deletes, skips or weakens (#351) …
scuttletoby Nov 17, 2026
fcd525f
pinned runner: realpath in the error handler, README wording (#383) (…
scuttletoby Nov 17, 2026
95fe172
pc-agents setup: repair an interrupted dpkg with no audit output; LC_…
scuttletoby Nov 17, 2026
afed2d5
fork CI: FORK_CHANGES.md checks move to the workflows job so fork-onl…
scuttletoby Nov 17, 2026
405d673
head gate: #375 follow-ups (one head two PRs, docs, caller if, case t…
scuttletoby Nov 17, 2026
1caf9d8
slots observer: a start uses its thread's held slot up with slots off…
scuttletoby Nov 17, 2026
c43bdf7
secret scan: gone tips fail closed, real one-by-one sweep test, shall…
scuttletoby Nov 17, 2026
af96a6d
fleet walls: one launcher pin, FIFO timeout, canary and resolv tests …
scuttletoby Nov 17, 2026
e10f9d3
server: fork service layers in one fork file (server.ts fork lines do…
scuttletoby Nov 17, 2026
61bc866
fork-ci: clean .git and fixed git config before checkout on self-host…
scuttletoby Nov 17, 2026
4844ae0
review gate: check the merged config, size caps, release note (#378 f…
scuttletoby Nov 17, 2026
4c96aa7
slots observer: count each hold once with slots off in every order (#…
scuttletoby Nov 17, 2026
2988047
fork-changes-list: fail closed on unusual forkDefaults rows (#396) (#…
scuttletoby Nov 17, 2026
e13e0da
head gate: #392 lens minors (docs wording, number-order tests) (#406)
scuttletoby Nov 17, 2026
0b5edb6
fork seam check: #277 follow-ups (moved/deleted lines, indentation, g…
scuttletoby Nov 17, 2026
057ebbf
handoff: HandoffService, size and idle triggers (HO2) (#320)
scuttletoby Nov 17, 2026
10ac25d
secret scan: drop the checkout's token before the scan fetches (#317 …
scuttletoby Nov 17, 2026
baf950e
golive: kit rehearse (R0-R5) on a clone of the copy (go-live PR 5) (#…
scuttletoby Nov 17, 2026
44c1778
head-check: config file mode + #403 follow-ups (#413) (#419)
scuttletoby Nov 17, 2026
88c092e
fix(fleet-desk): no race at serve(), tested lock owner and socket pee…
scuttletoby Nov 17, 2026
918abfc
desk: read .wslconfig values the way WSL does (repeated keys, comment…
scuttletoby Nov 17, 2026
7e64275
settings intervals: never-widen rule written down, recursive walk and…
scuttletoby Nov 17, 2026
1610d3e
fork-ci: git-clean hardening and test gaps (#411) (#418)
scuttletoby Nov 17, 2026
304bb9d
fork CI: fail fork-ci-result when fork-checks did not run (#401) (#420)
scuttletoby Nov 17, 2026
af461d4
fork seams: green from upstream on main; a PR's own list is format-ch…
scuttletoby Nov 17, 2026
1797059
golive rehearse: bind of a live-home subfolder, handle-based delete, …
scuttletoby Nov 17, 2026
a38ea51
Fork CI: split the walls tests off the lint job; pr-queue clears old …
scuttletoby Nov 17, 2026
aed1e46
pr-queue: read the config with git; head check refuses case-only twin…
scuttletoby Nov 17, 2026
ddae489
golive: kit back (W1-W3), status and runbook (go-live PR 7) (#397)
scuttletoby Nov 17, 2026
10af342
golive: runbook docs/fork/go-live.md (go-live PR 7, part 2) (#399)
scuttletoby Nov 17, 2026
eadfd48
fix(fork-ci): pr-queue config read fetches nothing; drop job GIT_* va…
scuttletoby Nov 17, 2026
7441acd
fork_checks_ran: base-commit config, pull_request_target runs only, r…
scuttletoby Nov 18, 2026
0af079a
fork seams: announce a new seam line, then add it; list guards and op…
scuttletoby Nov 18, 2026
8831a2f
fleet refresh: name budget in the unpacker, service doc nit (#209 ite…
scuttletoby Nov 18, 2026
44628b5
fix(golive): rehearse checks where live userdata really is, the mount…
scuttletoby Nov 18, 2026
fb72f87
fork seams: announce the seam lines of #398 and #412 (step 1) (#448)
scuttletoby Nov 18, 2026
444d9ac
fork_checks_ran: count a PR entry only from the run's own head branch…
scuttletoby Nov 18, 2026
5ecae86
fix(fork-ci): queue and gate drop GIT_ATTR_SOURCE and the job's git p…
scuttletoby Nov 18, 2026
50d0c1c
hold-work: a marker guards a held or stopped copy's home in the CLI; …
scuttletoby Nov 18, 2026
2fb88ff
remote delegate: record and follow a launched child even if the call …
scuttletoby Nov 18, 2026
13ab8cd
fix(golive): rehearse never clones a link out of its tree, nor lands …
scuttletoby Nov 18, 2026
5506d76
fix(fork-ci): weakened-tests refused test built a new head per run (#…
scuttletoby Nov 18, 2026
5d4479b
fork-ci: HEAD attributes ignored in the queue cache; local git calls …
scuttletoby Nov 18, 2026
719a8ed
go-live rehearse: clean refusals for bad live links, retryable walk e…
scuttletoby Nov 18, 2026
906a82d
fork-ci: fork_checks_ran budget margin, named contract FAILs, name-gu…
scuttletoby Nov 18, 2026
09dc311
fork-ci: queue cache checks stored objects before merge-tree (#453 fo…
scuttletoby Nov 18, 2026
092a838
fork-ci: desk-seed same-size rewrite no longer depends on timestamp r…
scuttletoby Nov 18, 2026
09c9dad
golive: kit switch, verify, automatic way back and guard timer (go-li…
scuttletoby Nov 18, 2026
cb5d504
fork mcp: wait_for and wait_list are hidden from outside clients
noreply Nov 18, 2026
ffb8dc9
fork mcp profile: upstream's issues tools get their own group
noreply Nov 18, 2026
cc1a53c
fork tests: held work against upstream's restart resend
noreply Nov 18, 2026
b231e4a
fork seams: counts after the rebase onto v0.1.11-nightly.20261117.4851
noreply Nov 18, 2026
24e1605
fork tests: follow upstream's CI after the rebase onto v0.1.11-nightl…
noreply Nov 18, 2026
b70381e
fork-seam-check: #436 round-2 follow-ups (#446) (#463)
scuttletoby Nov 18, 2026
79ab6f9
golive: restore and check follow-ups from #288's lenses (#300) (#471)
scuttletoby Nov 18, 2026
5aae1a3
fork settings: follow upstream's translated interface
noreply Nov 18, 2026
ff33f70
fork seams: counts after the rebase onto v0.1.11-nightly.20261118.4864
noreply Nov 18, 2026
091aa61
fork scripts: remove their own temp folders on every exit (#473) (#477)
scuttletoby Nov 18, 2026
e9f5ecd
golive back: W2/W3 may follow a W1 stuck on its verify (#440) (#472)
scuttletoby Nov 18, 2026
5ee13b1
tests: close four gaps found in the rebase reviews (#480)
scuttletoby Nov 18, 2026
6a8b930
golive tests: make FollowStuckW1 deterministic (#479) (#481)
scuttletoby Nov 18, 2026
af910d9
pr-queue: re-check merge-tree's objects right before it; FSCK_KNOWN o…
scuttletoby Nov 18, 2026
1960ed2
fork-temp-files tests: tighter checks (#478) (#483)
scuttletoby Nov 18, 2026
84c937e
fork seams: announce the ChatView test seam lines of #474 (step 1) (#…
scuttletoby Nov 18, 2026
8d36354
ChatView test: wait for the pasted image to be ready before Enter (#4…
scuttletoby Nov 18, 2026
51d459d
fork-ci: fix two flaky fork action tests (#493, #494) (#495)
scuttletoby Nov 18, 2026
2284c4c
fork-kit: cleaner kit, plan and run with hard refusals and three rule…
scuttletoby Nov 18, 2026
6951a31
hold-work: --hold-work needs --base-dir; one marker read per boot (#4…
scuttletoby Nov 18, 2026
508ef56
fork-follow: fetch the rebase's files first, name every stop (#475) (…
scuttletoby Nov 18, 2026
75e70cb
fork-cleaner report: GB per class and what runs freed (#490) (#499)
scuttletoby Nov 18, 2026
6e5cb80
fork-kit/cleaner: installer, daily timer (compare mode), compare, rep…
scuttletoby Nov 18, 2026
a02f6f3
Desktop: download updates in the background and install on quit (parked)
scuttletoby Nov 14, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
20 changes: 20 additions & 0 deletions .github/fork-actions-policies.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"about": "The one place the repository's Actions policy for pull_request_target is defined (issue #401). From 2026-12-02 GitHub blocks pull_request_target unless a repository Actions policy (Settings > Actions > Policies, rule 'Restrict events') allows it for the workflow file. pull_request_target.allowed: the fork workflows the policy must allow, exactly these. pull_request_target.upstream_blocked: upstream's workflows with that trigger; the fork keeps them disabled and the policy does not name them, so they stay blocked. fork-contracts.test.py (section policies) checks every workflow with the trigger is in one list. fork_checks: the job fork-tests.yml's fork_checks_ran job requires to have passed in the newest pull_request_target run of that workflow on a pull request's head (fork-checks-ran.py), so a blocked, failed or renamed fork-checks.yml fails the required fork-ci-result instead of passing silently. fork-checks-ran.py reads this section from the pull request's base commit (#430), so a pull request that renames the workflow or the job is judged by the names that are live; outside_check names the job that refuses outside pull requests, pinned by the contract test.",
"pull_request_target": {
"allowed": [".github/workflows/fork-checks.yml"],
"upstream_blocked": [
".github/workflows/desktop-macos-preview-publish.yml",
".github/workflows/pr-limits.yml",
".github/workflows/pr-size.yml",
".github/workflows/pr-vouch.yml",
".github/workflows/relay-preview-cleanup.yml"
]
},
"fork_checks": {
"workflow": ".github/workflows/fork-checks.yml",
"check": "No database schema changes",
"outside_check": "Outside pull request",
"wait_seconds": 600,
"poll_seconds": 20
}
}
18 changes: 18 additions & 0 deletions .github/fork-ci-release-rulesets.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
[
{
"name": "fork-ci release tags: never moved or deleted",
"target": "tag",
"enforcement": "active",
"bypass_actors": [],
"conditions": { "ref_name": { "include": ["refs/tags/ci/*"], "exclude": [] } },
"rules": [{ "type": "deletion" }, { "type": "update" }]
},
{
"name": "fork-ci release branch: no force push or delete",
"target": "branch",
"enforcement": "active",
"bypass_actors": [],
"conditions": { "ref_name": { "include": ["refs/heads/ci-release"], "exclude": [] } },
"rules": [{ "type": "deletion" }, { "type": "non_fast_forward" }]
}
]
21 changes: 21 additions & 0 deletions .github/fork-ci-release.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
{
"_comment": "The fork-ci release (.github/scripts/fork-ci-release.py, fork-ci/README.md). paths: the only files a release commit holds (fork-kit: host kits, installed from a release commit), at the same paths as on sourceBranch. legacyTags: tags made before release commits existed (they name a sourceBranch commit, not a release commit, and stay where they are).",
"sourceBranch": "main",
"requiredCheck": "fork-ci-result",
"branch": "ci-release",
"tagPrefix": "ci/v",
"legacyTags": ["ci/v1"],
"paths": [
"LICENSE",
"fork-ci",
"fork-kit",
".github/workflows/fork-pr-queue.yml",
".github/workflows/fork-head-gate.yml",
".github/scripts/fork-fleet.py",
".github/scripts/fork-fleet-walls.py",
".github/scripts/fork-fleet-walls",
".github/scripts/fork-fleet-launch.sh",
".github/scripts/fork-fleet-job-paths.txt",
"scripts/install.sh"
]
}
109 changes: 109 additions & 0 deletions .github/fork-ci-tests.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,109 @@
# Every test file under .github/scripts, fork-ci and fork-kit (*.test.*, subdirectories included) and
# where it runs (.github/scripts/fork-ci-tests.cjs checks this list).
# <test> run by Fork tests (fork-kit/ in the kit job, fork-ci/ and the
# fleet walls' in the action job, the rest in the workflows job),
# by extension (sh, py, cjs, mjs, js)
# <test> ~<seconds>s the same, with its usual time on CI: the longest start first.
# Tests without one start before them. A test over 30 s without
# one, or far from its weight, gets a note in the log to fix it.
# <test> run by <file> run by <file>, which must name the test's path (not one
# of upstream's workflows: they are disabled in the fork)
# A present test that is not listed fails. A listed file that is not present yet
# is a note; one that was present and then deleted fails.
.github/scripts/fork-ci-tests.test.cjs ~10s
.github/scripts/fork-checks-ran.test.py
.github/scripts/fork-contracts.test.py
.github/scripts/fork-fleet-desk-agent.test.py ~23s
.github/scripts/fork-fleet-desk-key.test.py ~10s
.github/scripts/fork-fleet-desk-seed.test.py ~10s
.github/scripts/fork-fleet-desk.test.py ~8s
.github/scripts/fork-fleet.test.py ~47s
.github/scripts/fork-fleet-refresh.test.py ~46s
.github/scripts/fork-fleet-walls.test.py ~75s
.github/scripts/fork-fleet-walls-contract.test.py ~100s
.github/scripts/fork-fleet-walls-wsl2.test.py ~36s
.github/scripts/fork-gate-trust-docs.test.py
.github/scripts/fork-head-gate-workflow.test.py
.github/scripts/fork-follow.test.sh ~32s
.github/scripts/fork-interaction-limit.test.sh
.github/scripts/fork-owned-paths.test.py
.github/scripts/fork-owned-reads.test.py run by .github/workflows/fork-tests.yml
.github/scripts/fork-pr-queue-workflow.test.py
.github/scripts/fork-ci-release.test.py
.github/scripts/fork-changes-list.test.cjs
.github/scripts/fork-release-workflow.test.py
.github/scripts/fork-release.test.sh ~5s
.github/scripts/fork-run-alert.test.sh
.github/scripts/fork-reusable-permissions.test.py
.github/scripts/fork-schema-check.test.cjs ~7s
.github/scripts/fork-seam-check.test.cjs
.github/scripts/fork-temp-files.test.sh
.github/scripts/fork-secret-scan.test.sh run by .github/workflows/fork-secret-scan.yml
.github/scripts/fork-test-shards.test.cjs
.github/scripts/fork-tests-drift.test.cjs
.github/scripts/fork-upstream-files-check.test.cjs
.github/scripts/fork-vitest-gc-check.test.cjs
.github/scripts/fork-workflow-triggers.test.cjs
fork-ci/actions/ci-demand/ci_demand.test.py ~13s
fork-ci/actions/docs-scope/docs-scope.test.py ~16s
fork-ci/actions/fleet-route/fleet_route.test.py
fork-ci/actions/fleet-watch/fleet_watch.test.py
fork-ci/actions/git-clean/git_clean.test.py
fork-ci/actions/gradle-cache/gradle_cache.test.py
fork-ci/actions/head-check/head_check.test.py ~12s
fork-ci/actions/head-check/head_gate.test.py
fork-ci/actions/job-changed/job-changed.test.py ~16s
fork-ci/actions/pinned/pinned.test.py
fork-ci/actions/pr-queue/lens.test.py
fork-ci/actions/pr-queue/pr_queue.test.py ~23s
fork-ci/actions/pr-queue/review_config.test.py
fork-ci/actions/pr-queue/review_glob.test.py
fork-ci/actions/pr-queue/review_judge.test.py
fork-ci/actions/pr-queue/tested-base/tested_base.test.py
fork-ci/actions/test-select/test-select.test.py ~15s
fork-ci/actions/test-select/trace-check.test.py
fork-ci/actions/weakened-tests/weakened_tests.test.py
fork-kit/cleaner/tests/daily.test.py
fork-kit/cleaner/tests/engine.test.py
fork-kit/cleaner/tests/guard.test.py
fork-kit/cleaner/tests/install.test.py
fork-kit/cleaner/tests/report.test.py
fork-kit/cleaner/tests/worktrees.test.py ~8s
fork-kit/common/tests/free_contract.test.py ~5s
fork-kit/common/tests/machine_file.test.py
fork-kit/desk/tests/install.test.py ~65s
fork-kit/desk/tests/windows.test.py ~8s
fork-kit/golive/tests/back.test.py ~35s
fork-kit/golive/tests/check.test.py
fork-kit/golive/tests/contract.test.py
fork-kit/golive/tests/copy.test.py ~26s
fork-kit/golive/tests/journal.test.py
fork-kit/golive/tests/rehearse.test.py ~22s
fork-kit/golive/tests/switch.test.py ~77s
fork-kit/gh-apps/tests/install.test.py
fork-kit/gh-apps/tests/mint.test.py
fork-kit/gh-apps/tests/policy.test.py
fork-kit/gh-apps/tests/run.test.py
fork-kit/gh-apps/tests/wrapper.test.py
# Real users and sudo on the throw-away runner, as root (it refuses anywhere else).
fork-kit/gh-apps/tests/root.test.py run by .github/workflows/fork-tests.yml
fork-kit/heavy/tests/install.test.py
fork-kit/heavy/tests/sweep.test.py ~25s
# A real systemd user manager (the step starts one for the runner user).
fork-kit/heavy/tests/heavy.test.py run by .github/workflows/fork-tests.yml
fork-kit/model-guard/tests/guard.test.py
fork-kit/model-guard/tests/install.test.py
fork-kit/pc-agents/tests/check.test.py ~22s
fork-kit/pc-agents/tests/setup.test.py ~110s

# Upstream's tests, run where fork-tests.yml follows upstream's ci.yml.
.github/scripts/check-nightly-release.test.cjs run by .github/workflows/fork-tests.yml
.github/scripts/mobile-preview-comment.test.cjs run by .github/workflows/fork-tests.yml
.github/scripts/mobile-ios-preview-record.test.cjs run by .github/workflows/fork-tests.yml
.github/scripts/stage-preview-bundle.test.py run by .github/workflows/fork-tests.yml
.github/scripts/test-delta.test.cjs run by .github/workflows/fork-tests.yml
.github/scripts/vercel-deployment-output.test.cjs run by .github/workflows/fork-tests.yml
# Upstream runs this one from thread-transfer-report.yml (workflow_run of the disabled CI).
.github/scripts/thread-transfer-report.test.cjs run by .github/workflows/fork-tests.yml
# Release Smoke runs scripts/release-smoke.ts, which runs this one.
.github/scripts/relay-state-output.test.cjs run by scripts/release-smoke.ts
83 changes: 83 additions & 0 deletions .github/fork-fleet-desk-key.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
# Desk link key tool (`desk-key`)

Fork only. `.github/scripts/fork-fleet-desk-key.py` runs on the always-on host. It keeps the
`authorized_keys` lines of the desk link: one line per desk pool, which lets that pool's desktop
log in only to run the desk link's `serve` for its own pool (row D2, `fork-fleet-desk.py`). The
fleet runbook is `.github/fork-fleet.md`.

```
desk-key = sudo -u fleet-desk -H /usr/bin/python3 -I /opt/fork-fleet/fork-fleet-desk-key.py --config /opt/fork-fleet/fork-fleet.json [--user NAME]

desk-key add POOL < desktop-key.pub # add POOL's line (one ssh-ed25519 public key on stdin)
desk-key status [POOL] # POOL's line, or every desk pool's and every retired pool's
desk-key remove POOL # remove POOL's line, also after POOL left the fleet config
```

The line it writes, and the only kind it removes:

```
restrict,command="/usr/bin/python3 -I /opt/fork-fleet/fork-fleet-desk.py serve POOL" ssh-ed25519 AAAA... fork-fleet-desk:POOL
```

Every other byte of the file stays as it was. Lines are split at `\n` only, as sshd splits
them. A line that names `fork-fleet-desk:POOL` but that the tool cannot read as one of its own
(for example one with a lone `\r` or another control byte in it, or a login line whose comment
contains a desk line) is shown by `status` and `remove` and never changed: edit it by hand.

## Exit codes

| Code | Meaning |
| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 0 | done; `status`: every line is the exact line this version writes |
| 1 | `status` or `remove` found a problem: a wrong line (run `remove`, then `add`), a line of a retired pool (run `remove POOL`), or a line naming a pool that the tool cannot read (edit it by hand) |
| 2 | refused, nothing changed: bad input, unknown pool, wrong user, unsafe file, bad config, bad usage |
| 3 | `status`: a desk pool has no line (and nothing else is wrong) |
| 4 | error: an unexpected failure (for example a full disk); the file is the old one or the new one, never half |

## The desk-link user

The key goes into the `authorized_keys` of one dedicated, unprivileged user (default
`fleet-desk`), never root's. The tool runs as that user and refuses:

- root, and any user other than `--user`;
- a user in an admin group: `root`, `sudo`, `wheel`, `admin`, `adm`, `docker`, `lxd`, `libvirt`,
`systemd-journal` (primary or supplementary);
- a system account (uid 999 or below) unless its name is the default `fleet-desk`, so a daemon's
account (for example a database's) never gets the link; a user with another name needs a uid of
1000 or more;
- a `$HOME` that is not the user's home in the password database (sshd reads that one; use
`sudo -H`);
- a `~/.ssh`, `authorized_keys` or home (when it makes `~/.ssh`) that the user does not own, that
is a symlink, or that group or others can write (sshd's StrictModes would ignore the file).

## Retiring a desktop

Take its pool out of the fleet config, then run `desk-key remove POOL`. `status` without a pool
reports any line left for a pool the config no longer has: "key for retired pool POOL still
allows a login: run desk-key remove POOL" (exit 1).

## What the setup (D8) must guarantee

The tool cannot check these from the desk-link user's side. The setup row (D8) makes them true
and its PASS/FAIL check proves them:

1. **The user and its password field.** The desk-link user is a system user with only its own
group: no `sudo`, `wheel`, `adm`, `docker` or `systemd-journal`, and no sudoers rule. Its shell
is `/bin/sh` (sshd runs the forced command through it, so `nologin` would close the link). Its
password field is `*`: not empty, and not `!` either, because with `UsePAM no` OpenSSH treats a
`!` account as locked and refuses even the key. Its home and `~/.ssh` are owned by it and are
not group- or world-writable.
2. **sshd settings for that user.** A `Match User <desk-link user>` block with
`AuthenticationMethods publickey`, `DisableForwarding yes`, `PermitTTY no`, `PermitTunnel no`,
`PermitUserRC no`, `AllowAgentForwarding no`, `X11Forwarding no`. `PermitUserEnvironment`
stays `no`. No `PermitRootLogin` change. If `AllowUsers` or `AllowGroups` is set, the user is
added to it. The check runs `sshd -T -C user=...,host=...,addr=...` and checks that
`authorizedkeysfile` is `.ssh/authorized_keys` and that those values hold.
3. **The /run folder.** `/run/fork-fleet-desk` is made by tmpfiles, owned by the desk-link user,
mode 0710 with the socket group, and the desk link's `launch` accepts that owner.
4. **Root-owned install files.** `/opt/fork-fleet`, `fork-fleet-desk.py` and this tool are owned
by root and not writable by the desk-link user; `/usr/bin/python3` exists (the forced command
names it by its full path).
5. **A key used for nothing else.** The desktop's link key is made only for the link and kept by
root on the desktop. The check confirms, as root and read-only, that its fingerprint is in no
other `authorized_keys` on the host (root's, an admin's).
60 changes: 60 additions & 0 deletions .github/fork-fleet.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
{
"_doc": [
"Where fork-tests.yml's Linux jobs run: this repository's own fleet of self-hosted runners, or GitHub-hosted.",
"The one place for every fact about this repository and its fleet: .github/scripts/fork-fleet.py has none.",
"Read by `route` (a step of fork-tests.yml's changes job), `watch` (fork-tests.yml), `sweep` (fork-fleet.yml),",
"and on each fleet host by `dispatch` and `gate` (an installed copy of main's script and of this file).",
"The setting is the repository variable named in `variable`: auto (unset too), fleet or github.",
"Runbook, owner steps and the failure table: .github/fork-fleet.md."
],
"repository": "scuttletoby/t3code",
"variable": "CI_RUNNERS",
"hosted": "ubuntu-24.04",
"trusted": {
"workflows": [".github/workflows/fork-tests.yml"],
"actors": ["scuttletoby"],
"push_branches": ["main"]
},
"upstream_sync": {
"_doc": [
"Upstream's code runs on GitHub-hosted runners only (owner decision). The daily sync pushes main with the owner's",
"token, so its push run would pass `trusted`: scripts/fork-follow-push.sh tags each commit it moves main to as",
"<tag_prefix><sha> before the move, and a push run of a tagged commit never uses the fleet. Keep the tags: a",
"run can be re-run for 30 days."
],
"tag_prefix": "fork-follow/synced/"
},
"pools": [
{
"_doc": "The owner's PC, a desk pool: its desk agent dials out to the always-on host, whose dispatcher for this pool starts runners on the PC through that link (fork-fleet.md, The desk link).",
"name": "pc",
"label": "fleet-pc-t3code",
"slots": 1,
"beacon": "FLEET_BEACON_PC",
"launch": ["python3", "-I", "/opt/fork-fleet/fork-fleet-desk.py", "launch", "pc"],
"waits": false
},
{
"_doc": "The always-on host (the owner's workspace, not a VM of its own): each runner runs as its own user in its own network namespace with internet only (fork-fleet.md, Containment). Fleet mode queues here.",
"name": "vm",
"label": "fleet-vm-t3code",
"slots": 2,
"beacon": "FLEET_BEACON_VM",
"launch": ["/opt/fork-fleet/fork-fleet-launch.sh"],
"waits": true
}
],
"beacon_fresh_seconds": 180,
"stuck_seconds": 600,
"fleet_stuck_seconds": 7200,
"dispatch": { "every_seconds": 20, "beacon_seconds": 60, "idle_passes": 3 },
"jobs": [
{ "job": "test", "shards": 2, "gates": ["test"], "memory_mb": 4096 },
{ "job": "test_web", "shards": 3, "gates": ["test_web"], "memory_mb": 4096 },
{ "job": "build", "gates": ["build", "typecheck"], "memory_mb": 4096 },
{ "job": "lint", "gates": [], "memory_mb": 3072 },
{ "job": "rust", "gates": ["rust"], "memory_mb": 2048 },
{ "job": "test_server", "shards": 8, "gates": ["test_server"], "memory_mb": 3072 },
{ "job": "release_smoke", "gates": ["release_smoke"], "memory_mb": 2048 }
]
}
Loading
Loading