Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
253 commits
Select commit Hold shift + click to select a range
400c6ce
fork: CI check that refuses database schema and migration changes (#3)
scuttletoby Nov 12, 2026
b73e61c
fork: green main again (schema-check comments, checkout without submo…
scuttletoby Nov 12, 2026
1c4c3c8
fork: follow each stable upstream release with the patch series (#4)
scuttletoby Nov 12, 2026
1a13796
fork: outside PRs run nothing, one checkout without actions/checkout,…
scuttletoby Nov 12, 2026
1fae1cd
fork: delete four outside-started upstream workflows and keep them de…
scuttletoby Nov 12, 2026
2961d94
fork: follow upstream's newest nightly tag (FORK_FOLLOW_CHANNEL, defa…
scuttletoby Nov 13, 2026
63e3de2
feat(web): file links open remotely, full size, download from their m…
scuttletoby Nov 13, 2026
72f4e99
fork-ci: docs-scope composite action (docs-only gate and per-job path…
scuttletoby Nov 13, 2026
25cc989
fork-ci: gradle-cache composite action (locked Maven local repository…
scuttletoby Nov 13, 2026
bcc1ded
fork: the fork-follow test's fake gh no longer reads as a real workfl…
scuttletoby Nov 14, 2026
9a09c0c
fork: Fork tests on the repository's own fleet runners, chosen per ru…
scuttletoby Nov 14, 2026
8e32a01
fork-ci: job-changed composite action (did this workflow job's inputs…
scuttletoby Nov 14, 2026
920d639
fork-ci pr-queue 1/4: lens review rules and a strict config (#18)
scuttletoby Nov 14, 2026
4468722
fork-ci pr-queue 2/4: the queue's merge path (pr_queue.py) (#19)
scuttletoby Nov 14, 2026
f57e95b
fork-ci pr-queue 3/4: armed pull requests that cannot merge are told …
scuttletoby Nov 14, 2026
8e4ae08
fork-ci pr-queue 4/4: update a PR that was red only because its base …
scuttletoby Nov 14, 2026
7bf4c85
docs(fork): host tools design: agents on a person's own computer (lim…
scuttletoby Nov 14, 2026
ed6e540
fork-ci pr-queue: leftover minors from the stack reviews (#32)
scuttletoby Nov 14, 2026
134aa86
Fork: weekly check that the repository's interaction limit never laps…
scuttletoby Nov 14, 2026
302b135
Fork: head-check action, the queue's required head check with lens.py…
scuttletoby Nov 14, 2026
3236d04
fork-ci: release commits that hold only fork-ci, protected tags (#35)
scuttletoby Nov 14, 2026
464f9dd
feat(server): keep a history of provider usage-limit readings (#24)
scuttletoby Nov 14, 2026
8b0d9a8
fork: document the anchor machine as load-balancing weights; old sett…
scuttletoby Nov 14, 2026
83855a0
feat(server): refresh usage limits while no client watches (usage pac…
scuttletoby Nov 14, 2026
8e5fb49
Auto-update (server): background service updates itself when quiet (#5)
scuttletoby Nov 14, 2026
2291650
fork-fleet: route for any repository (hosted:false, static pools, per…
scuttletoby Nov 14, 2026
07c333f
fork-ci: fleet-route action and a usage guide for every action (#55)
scuttletoby Nov 14, 2026
1eee079
fork-ci: read reviews' edit and hidden flags with our own query (#56)…
scuttletoby Nov 14, 2026
4c38891
fork-follow: grant actions: write to the release call; test called-wo…
scuttletoby Nov 14, 2026
9c8165d
feat(usage): UsagePacer, pace per provider instance and window (pacin…
scuttletoby Nov 14, 2026
3606eca
fork: delete upstream's issue-vouch.yml and keep it deleted
scuttletoby Nov 14, 2026
edb43cf
fork-tests: follow upstream's test jobs at v0.1.10-nightly.20261114.4669
scuttletoby Nov 14, 2026
d945537
docs(fork-fleet): name no machine ids in the public docs (#74)
scuttletoby Nov 14, 2026
957db65
pr-queue lens: clean_inline keeps the source's answers in linear time…
scuttletoby Nov 14, 2026
a85ad0d
fix(pr-queue): wait out the queued-check race, tell a conflicted PR, …
scuttletoby Nov 14, 2026
5533a6e
feat(usage): usage pacing gate on delegate_task (pacing part 4) (#73)
scuttletoby Nov 14, 2026
dac1511
fix(secret-scan): skip upstream's commits in push ranges (#75)
scuttletoby Nov 14, 2026
e2b3f9f
feat(waits): contracts and pure functions for wait_for and agent slot…
scuttletoby Nov 14, 2026
4bc4145
feat(slots): agent slot gate on delegate_task (off by default) (#89)
scuttletoby Nov 14, 2026
36b4bcc
fork-kit/gh-apps: host install kit for GitHub App tokens (gate-trust …
scuttletoby Nov 14, 2026
ffed7af
feat(waits): wait store and service (off, not wired) (#90)
scuttletoby Nov 14, 2026
1e8b452
fork-ci: head gate, the head check as a gate App's check run (#34) (#85)
scuttletoby Nov 14, 2026
bce8607
docs(fork): gate trust, what the head gate proves and the owner's ste…
scuttletoby Nov 14, 2026
9939d24
fork-ci: Python API for docs-scope, a no_build key, and pinned (run f…
scuttletoby Nov 14, 2026
441886a
feat(waits): delivery and scheduling (part 3, off by default) (#91)
scuttletoby Nov 14, 2026
ea88ee0
fork-checks: refuse fork changes to upstream's Orchestrator.ts and ag…
scuttletoby Nov 14, 2026
e8a9ce5
Add settings UI for agent waits, wait checks and agent slots (waitfor…
scuttletoby Nov 14, 2026
551cbdb
feat(waits): agent tools to register, list and cancel waits (part 4, …
scuttletoby Nov 14, 2026
8d326dd
feat(waits): check and unit judges, outage wake cap (part 5, off by d…
scuttletoby Nov 15, 2026
decb52d
feat(waits): the pr judge (part 6, off by default) (#109)
scuttletoby Nov 15, 2026
6cfb8ee
Fork (waits PR 8): slot waits, woken when an agent slot frees (#110)
scuttletoby Nov 15, 2026
88273b0
fix(waits): pin pr wait targets, re-look a timed-out remote, keep slo…
scuttletoby Nov 15, 2026
4d28328
fork-ci: ci-demand, a read-only CI demand measure (#113)
scuttletoby Nov 15, 2026
a044769
fix(waits): monotonic judge deadlines, early messages, hidden-hold co…
scuttletoby Nov 15, 2026
0196e5b
fork-ci: ci-demand follow-ups (cache write failure shown, BOM, NaN da…
scuttletoby Nov 15, 2026
b158b59
fork: read-only report command (go-live kit PR 2) (#172)
scuttletoby Nov 15, 2026
4c2047d
Fork default pin: one row per fork setting, #51 fix, #44 test, sync r…
scuttletoby Nov 15, 2026
64521d0
fork-kit: heavy stops what its command leaves behind (#173)
scuttletoby Nov 15, 2026
8beb3b4
fork report: follow a symlinked DB and warn on an empty settings file…
scuttletoby Nov 15, 2026
2832e95
fork: delegate checks behind one fork module (SEAM) (#174)
scuttletoby Nov 15, 2026
9579498
fork settings: fork keys live in forkSettings.ts (FS0) (#185)
scuttletoby Nov 15, 2026
dc7250b
fork: serve --hold-work (go-live kit PR 1) (#175)
scuttletoby Nov 15, 2026
1df9ff6
fork-kit: heavy sweep finds what escaped heavy; common machine-file l…
scuttletoby Nov 15, 2026
a90e745
fork-kit/golive: kit core (config, lock and journal, live T3, check, …
scuttletoby Nov 15, 2026
4856a78
fork fleet: desk link, always-on side (D2) (#192)
scuttletoby Nov 15, 2026
69c5461
fork fleet: desk link key tool (D4) (#195)
scuttletoby Nov 15, 2026
b5efc4e
dynamic slots: capacity rule, shared vectors, pure evaluator (DS1) (#…
scuttletoby Nov 15, 2026
9e01afe
fork fleet: launcher walls for every pool (D1) (#191)
scuttletoby Nov 15, 2026
757f6ff
Secret scan: merges with hand-resolved conflicts no longer fail the s…
scuttletoby Nov 15, 2026
bab48b8
fork fleet: per-OS walls layer (D5) (#194)
scuttletoby Nov 15, 2026
374d7c3
fork fleet: walls proof for a new kind of host (stacked on #191) (#198)
scuttletoby Nov 15, 2026
c6fc361
fork fleet: desk link, desktop side (D3) (#205)
scuttletoby Nov 15, 2026
2809cb7
fork fleet: runner template refresh + daily timer (D7) (#196)
scuttletoby Nov 15, 2026
6edad45
Secret scan: settings from the default branch, fail on octopus merges…
scuttletoby Nov 15, 2026
6e11bf4
fork-fleet: walls re-check minors (#191, #194, #198) (#208)
scuttletoby Nov 15, 2026
4f725cd
fork fleet: WSL2 walls (D6) (#197)
scuttletoby Nov 15, 2026
14ab2b8
Secret scan: repository settings, binary and UTF-16 contents, squash-…
scuttletoby Nov 15, 2026
f9c78d4
Secret scanning: GitHub's scanner skips .gitleaks.toml (#216)
scuttletoby Nov 15, 2026
200efbf
docs(fork): list fork changes and settings, pinned to the defaults ta…
scuttletoby Nov 15, 2026
6d93cd3
fleet walls: read units and every property form, one kit, root-owned …
scuttletoby Nov 15, 2026
35d615b
Secret scan: replaced heads, every push, main's script, exact-value a…
scuttletoby Nov 15, 2026
8f3de1d
fork-ci fleet-route: a job may avoid a dispatcher pool for some kinds…
scuttletoby Nov 15, 2026
f484c19
fork-ci fleet-route: a person's re-run of failed jobs may use a dispa…
scuttletoby Nov 15, 2026
c7a86f8
docs: a short block at the top of the README naming what the fork add…
scuttletoby Nov 15, 2026
087d9e4
MCP profiles 1: settings and the profile resolver (nothing calls it y…
scuttletoby Nov 16, 2026
cf98b90
fleet walls: the seven #226 follow-ups (fail closed) (#240)
scuttletoby Nov 16, 2026
e741d4f
fork-ci: fleet-watch action (watch, sweep, pending) for runs a dispat…
scuttletoby Nov 16, 2026
6674d1d
golive: kit copy (practice stop, cold copy, restore primitive) (#228)
scuttletoby Nov 16, 2026
f954547
fork fleet: desk setup pack kit (D8) (#225)
scuttletoby Nov 16, 2026
252057f
fork fleet: Windows starter for a desk pool (D9) (#229)
scuttletoby Nov 16, 2026
00ef675
fork fleet: free/v1 "is this machine free?" contract and examples (D1…
scuttletoby Nov 16, 2026
d7d1bff
fork-kit: pc-agents walls and their check (part 1 of 2) (#232)
scuttletoby Nov 16, 2026
f0f3e10
fork-kit: pc-agents setup, bootstrap and owner steps (part 2 of 2) (#…
scuttletoby Nov 16, 2026
2712283
fork fleet: `seed` verb and `seeds` in the fleet config (D11) (#236)
scuttletoby Nov 16, 2026
ca1287b
Test Web: three shards, Chromium garbage collected after every file (…
scuttletoby Nov 16, 2026
d3c11ba
Fork script tests: longest first, kit tests in their own job, secret-…
scuttletoby Nov 16, 2026
7a1f018
pr-queue: never delete a merged branch with the token; stacked PRs st…
scuttletoby Nov 16, 2026
e684bcb
fork-fleet-walls tests: the fixture contract in its own file (#252)
scuttletoby Nov 17, 2026
f8cd1a9
Fork tests: a fork-only pull request skips the app jobs (#251)
scuttletoby Nov 17, 2026
65b2bfa
pr-queue: read with the run's GITHUB_TOKEN, write with the PAT (#255)
scuttletoby Nov 17, 2026
2621308
fork CI: warn when merged branches stay; test that nothing outside th…
scuttletoby Nov 17, 2026
9531575
fork-ci test-select: run only the test files a pull request's change …
scuttletoby Nov 17, 2026
5ba8cb3
fork fleet: a desktop fetches its desk pool's seeds (D11b) (#237)
scuttletoby Nov 17, 2026
8c097ab
fork fleet: desk pool docs, a neutral example, the fork's pc pool on …
scuttletoby Nov 17, 2026
deea004
fork: playtest settings and adapter contract (server.playtest) (#260)
scuttletoby Nov 17, 2026
1f14e51
feat(playtest): session store and service (claim, rounds, release) (#…
scuttletoby Nov 17, 2026
1d32ed2
fork-ci release: carry the files pc-agents setup copies (#263)
scuttletoby Nov 17, 2026
6229b8f
feat(playtest): worker: renew, idle and time limit, end with the thre…
scuttletoby Nov 17, 2026
69257b9
fork-kit: PC setup passes on a fresh WSL2 distro (container mark, T3 …
scuttletoby Nov 17, 2026
2f70224
pc-agents: policy names only settings every T3 knows; show T3's error…
scuttletoby Nov 17, 2026
ddf3213
fix(server): usage history misses no update during start-up (#60) (#272)
scuttletoby Nov 17, 2026
afa84ea
pc-agents: start errors, pairing from the command line, setup notes (…
scuttletoby Nov 17, 2026
6141aeb
fork report: settings with comments, a file as data folder, no leftov…
scuttletoby Nov 17, 2026
5ccfaa5
fleet + pr-queue: tests for the private check, waiting-pool order, re…
scuttletoby Nov 17, 2026
ac545ae
ci-demand: bad input files report a problem instead of crashing (#166…
scuttletoby Nov 17, 2026
b2d6b97
fix(server): fork report prints JSON for a home it cannot look at (#2…
scuttletoby Nov 17, 2026
d9869af
pc-agents: pair names a missing T3, packages Node needs, minimum T3; …
scuttletoby Nov 17, 2026
e845524
fleet units: own stop timeout, tested job walls (#217 #204) (#280)
scuttletoby Nov 17, 2026
5716c66
handoff: person-only setting and pure handoff decision (HO1) (#282)
scuttletoby Nov 17, 2026
94a10c0
golive: report only beside a steady T3, counts report to report, rest…
scuttletoby Nov 17, 2026
1c25aae
fix(pr-queue): lens opt-out blocks a read written another way; one-pa…
scuttletoby Nov 17, 2026
fe5faba
ci-demand: item-level cache damage, --json clean-up, date tests (#287…
scuttletoby Nov 17, 2026
356e399
dynamic slots: capacity readings: swap, pressure, live total, per-pie…
scuttletoby Nov 17, 2026
38ec26d
contracts: reviewRules person-only setting and recommended preset (PK…
scuttletoby Nov 17, 2026
be87a08
fix(fork-kit/heavy): sweep keeps kept containers and hides inline cod…
scuttletoby Nov 17, 2026
1c865fa
fork-ci: README startup block checks the cache folder before using it…
scuttletoby Nov 17, 2026
9a95313
usage history: start-up drain replay not stored as a full read; test …
scuttletoby Nov 17, 2026
286517d
fleet: walls skip a job unit that just ended, stamp the lookup time, …
scuttletoby Nov 17, 2026
a0c0d66
fleet dispatcher: clean up offline registrations under a pool's retir…
scuttletoby Nov 17, 2026
e81302f
pc-agents: prerelease below its release, packages after resolv.conf, …
scuttletoby Nov 17, 2026
3f65f77
fork-ci pr-queue: parse and validate the `review` block (PK10 C1) (#301)
scuttletoby Nov 17, 2026
179af3e
fix(server): usage refresher skips healthy OpenCode like upstream; te…
scuttletoby Nov 17, 2026
d1b1d99
secret scan: full rule id check, shallow refusal, alert de-dup, guard…
scuttletoby Nov 17, 2026
fe9b351
fork-ci pinned: follow-ups from #305 (cache race, import check spelli…
scuttletoby Nov 17, 2026
b38cc78
usage refresher: clear the failure streak on the healthy skip (#322) …
scuttletoby Nov 17, 2026
904056f
settings: Duration fields from one list; a bad saved interval falls b…
scuttletoby Nov 17, 2026
5e7aeb7
usage refresher: end a failure streak only on a truly healthy skip (#…
scuttletoby Nov 17, 2026
c729a8d
fork-ci pinned: run folder in the cache, usual spellings, __cached__ …
scuttletoby Nov 17, 2026
9a62ef6
fleet dispatcher: follow-ups from #309 (old-label runners, label reus…
scuttletoby Nov 17, 2026
3357dca
usage refresher: pin the comeback retry delay and skip-guard checks (…
scuttletoby Nov 17, 2026
e1fa5e7
fork-ci head-check: judge required lenses by changed path (PK10 C2) (…
scuttletoby Nov 17, 2026
914b4a3
pc-agents: follow-ups from the #308 lens (#321) (#338)
scuttletoby Nov 17, 2026
9e0dd71
heavy sweep: follow-ups from #289 round 2 (#312) (#328)
scuttletoby Nov 17, 2026
31d0fd2
dynamic slots: slot gate observe mode, mode setting, old settings map…
scuttletoby Nov 17, 2026
990ec00
settings: interval walk handles union-wrapped intervals; good-value t…
scuttletoby Nov 17, 2026
96a47bf
fleet dispatcher: only stop old-label runners whose unit is here; cou…
scuttletoby Nov 17, 2026
ef0a446
fork-kit: model-guard hook, model policy v0 (M0) (#275)
scuttletoby Nov 17, 2026
edd204b
web: review rules settings panel with recommended preset button (PK10…
scuttletoby Nov 17, 2026
e8fc7e2
fork-ci pinned: check folders above the cache, more import spellings,…
scuttletoby Nov 17, 2026
7575a3c
fleet walls: launcher timeout read refuses what start() never passes;…
scuttletoby Nov 17, 2026
990c953
fleet dispatcher: stop only runners whose unit is here, both labels; …
scuttletoby Nov 17, 2026
ed07eb2
hold-work: a held server does not start T3 Connect; tests for every h…
scuttletoby Nov 17, 2026
bdd2f21
heavy sweep: = words after env, -S depth cap, php -d and other option…
scuttletoby Nov 17, 2026
b1f2e2d
C2 path judge: non-UTF-8 names, config path spelling, rule order, wor…
scuttletoby Nov 17, 2026
ad2affd
fork seam check: every upstream file counted, allow list from main (#…
scuttletoby Nov 17, 2026
29c6c16
fleet-route docs: two dispatchers on one pool race; table row; split …
scuttletoby Nov 17, 2026
720aa20
pinned: folder check in load(), doctest loader, clean refusal for an …
scuttletoby Nov 17, 2026
85f767e
review rules panel: test the hook's failure labels and the clear-over…
scuttletoby Nov 17, 2026
0b640c4
head gate: re-run after reviews and inline review comments via workfl…
scuttletoby Nov 17, 2026
96ad877
fleet walls: jobs see an allow-list of /etc, not all of it (#243) (#360)
scuttletoby Nov 17, 2026
3390929
pinned runner: #369 lens follow-ups (real folder named through symlin…
scuttletoby Nov 17, 2026
3c788aa
slots observe: one count per agent, stored held slots, seams list, te…
scuttletoby Nov 17, 2026
d55535a
fix(fork-ci): C2 path judge follow-ups from the #359 lenses (#374) (#…
scuttletoby Nov 17, 2026
3bfd006
fork-ci: report existing tests a PR deletes, skips or weakens (#351) …
scuttletoby Nov 17, 2026
8d85e20
pinned runner: realpath in the error handler, README wording (#383) (…
scuttletoby Nov 17, 2026
913642b
pc-agents setup: repair an interrupted dpkg with no audit output; LC_…
scuttletoby Nov 17, 2026
ef3025e
fork CI: FORK_CHANGES.md checks move to the workflows job so fork-onl…
scuttletoby Nov 17, 2026
0b35d85
head gate: #375 follow-ups (one head two PRs, docs, caller if, case t…
scuttletoby Nov 17, 2026
36e79e1
slots observer: a start uses its thread's held slot up with slots off…
scuttletoby Nov 17, 2026
d28ea1c
secret scan: gone tips fail closed, real one-by-one sweep test, shall…
scuttletoby Nov 17, 2026
8997193
fleet walls: one launcher pin, FIFO timeout, canary and resolv tests …
scuttletoby Nov 17, 2026
fbcc9bb
server: fork service layers in one fork file (server.ts fork lines do…
scuttletoby Nov 17, 2026
5db2339
fork-ci: clean .git and fixed git config before checkout on self-host…
scuttletoby Nov 17, 2026
afb5574
review gate: check the merged config, size caps, release note (#378 f…
scuttletoby Nov 17, 2026
209dc0d
slots observer: count each hold once with slots off in every order (#…
scuttletoby Nov 17, 2026
786a4da
fork-changes-list: fail closed on unusual forkDefaults rows (#396) (#…
scuttletoby Nov 17, 2026
19f4e9f
head gate: #392 lens minors (docs wording, number-order tests) (#406)
scuttletoby Nov 17, 2026
5176612
fork seam check: #277 follow-ups (moved/deleted lines, indentation, g…
scuttletoby Nov 17, 2026
5ec591a
handoff: HandoffService, size and idle triggers (HO2) (#320)
scuttletoby Nov 17, 2026
9e08970
secret scan: drop the checkout's token before the scan fetches (#317 …
scuttletoby Nov 17, 2026
5e0e5ec
golive: kit rehearse (R0-R5) on a clone of the copy (go-live PR 5) (#…
scuttletoby Nov 17, 2026
7fd0877
head-check: config file mode + #403 follow-ups (#413) (#419)
scuttletoby Nov 17, 2026
1336f99
fix(fleet-desk): no race at serve(), tested lock owner and socket pee…
scuttletoby Nov 17, 2026
be12beb
desk: read .wslconfig values the way WSL does (repeated keys, comment…
scuttletoby Nov 17, 2026
89d9a88
settings intervals: never-widen rule written down, recursive walk and…
scuttletoby Nov 17, 2026
38c6fa7
fork-ci: git-clean hardening and test gaps (#411) (#418)
scuttletoby Nov 17, 2026
5fbc7c2
fork CI: fail fork-ci-result when fork-checks did not run (#401) (#420)
scuttletoby Nov 17, 2026
add4b33
fork seams: green from upstream on main; a PR's own list is format-ch…
scuttletoby Nov 17, 2026
96bf743
golive rehearse: bind of a live-home subfolder, handle-based delete, …
scuttletoby Nov 17, 2026
2c51df3
Fork CI: split the walls tests off the lint job; pr-queue clears old …
scuttletoby Nov 17, 2026
72ed866
pr-queue: read the config with git; head check refuses case-only twin…
scuttletoby Nov 17, 2026
ca86439
golive: kit back (W1-W3), status and runbook (go-live PR 7) (#397)
scuttletoby Nov 17, 2026
5384443
golive: runbook docs/fork/go-live.md (go-live PR 7, part 2) (#399)
scuttletoby Nov 17, 2026
dbdd05d
fix(fork-ci): pr-queue config read fetches nothing; drop job GIT_* va…
scuttletoby Nov 17, 2026
dd7f03e
fork_checks_ran: base-commit config, pull_request_target runs only, r…
scuttletoby Nov 18, 2026
7d15e67
fork seams: announce a new seam line, then add it; list guards and op…
scuttletoby Nov 18, 2026
619cef7
fleet refresh: name budget in the unpacker, service doc nit (#209 ite…
scuttletoby Nov 18, 2026
89dc3c0
fix(golive): rehearse checks where live userdata really is, the mount…
scuttletoby Nov 18, 2026
8b56123
fork seams: announce the seam lines of #398 and #412 (step 1) (#448)
scuttletoby Nov 18, 2026
09f2c98
fork_checks_ran: count a PR entry only from the run's own head branch…
scuttletoby Nov 18, 2026
e3fc0fa
fix(fork-ci): queue and gate drop GIT_ATTR_SOURCE and the job's git p…
scuttletoby Nov 18, 2026
67c516a
hold-work: a marker guards a held or stopped copy's home in the CLI; …
scuttletoby Nov 18, 2026
b293d3a
remote delegate: record and follow a launched child even if the call …
scuttletoby Nov 18, 2026
e8c955f
fix(golive): rehearse never clones a link out of its tree, nor lands …
scuttletoby Nov 18, 2026
2e5e0a9
fix(fork-ci): weakened-tests refused test built a new head per run (#…
scuttletoby Nov 18, 2026
38ab28b
fork-ci: HEAD attributes ignored in the queue cache; local git calls …
scuttletoby Nov 18, 2026
b4383c5
go-live rehearse: clean refusals for bad live links, retryable walk e…
scuttletoby Nov 18, 2026
b400c27
fork-ci: fork_checks_ran budget margin, named contract FAILs, name-gu…
scuttletoby Nov 18, 2026
7d78149
fork-ci: queue cache checks stored objects before merge-tree (#453 fo…
scuttletoby Nov 18, 2026
85e8c13
fork-ci: desk-seed same-size rewrite no longer depends on timestamp r…
scuttletoby Nov 18, 2026
c40cc6e
golive: kit switch, verify, automatic way back and guard timer (go-li…
scuttletoby Nov 18, 2026
b608da9
fork mcp: wait_for and wait_list are hidden from outside clients
noreply Nov 18, 2026
a52d0cf
fork mcp profile: upstream's issues tools get their own group
noreply Nov 18, 2026
919ad4a
fork tests: held work against upstream's restart resend
noreply Nov 18, 2026
b38e662
fork seams: counts after the rebase onto v0.1.11-nightly.20261117.4851
noreply Nov 18, 2026
3c44453
fork tests: follow upstream's CI after the rebase onto v0.1.11-nightl…
noreply Nov 18, 2026
8bf9204
fork-seam-check: #436 round-2 follow-ups (#446) (#463)
scuttletoby Nov 18, 2026
df63cbd
golive: restore and check follow-ups from #288's lenses (#300) (#471)
scuttletoby Nov 18, 2026
6ab7ab1
fork settings: follow upstream's translated interface
noreply Nov 18, 2026
8cd2edd
fork seams: counts after the rebase onto v0.1.11-nightly.20261118.4864
noreply Nov 18, 2026
a6bb7e8
fork scripts: remove their own temp folders on every exit (#473) (#477)
scuttletoby Nov 18, 2026
02fb15e
golive back: W2/W3 may follow a W1 stuck on its verify (#440) (#472)
scuttletoby Nov 18, 2026
c1c1908
tests: close four gaps found in the rebase reviews (#480)
scuttletoby Nov 18, 2026
7a65a12
golive tests: make FollowStuckW1 deterministic (#479) (#481)
scuttletoby Nov 18, 2026
edb5a90
pr-queue: re-check merge-tree's objects right before it; FSCK_KNOWN o…
scuttletoby Nov 18, 2026
f40069e
fork-temp-files tests: tighter checks (#478) (#483)
scuttletoby Nov 18, 2026
262814a
fork seams: announce the ChatView test seam lines of #474 (step 1) (#…
scuttletoby Nov 18, 2026
837c32f
ChatView test: wait for the pasted image to be ready before Enter (#4…
scuttletoby Nov 18, 2026
c74c375
fork-ci: fix two flaky fork action tests (#493, #494) (#495)
scuttletoby Nov 18, 2026
3b04fb7
fork-kit: cleaner kit, plan and run with hard refusals and three rule…
scuttletoby Nov 18, 2026
75cac8e
hold-work: --hold-work needs --base-dir; one marker read per boot (#4…
scuttletoby Nov 18, 2026
68f8abd
fork-follow: fetch the rebase's files first, name every stop (#475) (…
scuttletoby Nov 18, 2026
52d1804
fork-cleaner report: GB per class and what runs freed (#490) (#499)
scuttletoby Nov 18, 2026
6114bc0
fork-kit/cleaner: installer, daily timer (compare mode), compare, rep…
scuttletoby Nov 18, 2026
e2941a3
usage history: keep clock step-backs through thinning; test clock gua…
scuttletoby Nov 18, 2026
2704720
fork report: retry any failed first read, clearer home wording, pin l…
scuttletoby Nov 18, 2026
12e6df8
go-live: no waiting periods between rollout steps (#505)
scuttletoby Nov 18, 2026
6f259fa
Refs #311, Fixes #325, Fixes #416: seam check follow-ups (#506)
scuttletoby Nov 18, 2026
bca1a0b
fork release: pin Linux runners to ubuntu-24.04 (#507)
scuttletoby Nov 18, 2026
2379263
cleaner: compress-cold rule shrinks cold files with checked zstd copi…
scuttletoby Nov 18, 2026
49a7c5d
cleaner: agent-scratch rule with a keep-first step (#489) (#512)
scuttletoby Nov 18, 2026
10b17d7
fork-kit/heavy: one memory queue for heavy jobs (heavy --kind) (#515)
scuttletoby Nov 19, 2026
c19cfc0
fork-ci: law tests — shared contract, stdlib runner, pr-queue pilot (…
scuttletoby Nov 19, 2026
0c5b291
fork seams: announce the Rosetta compile-cache warm-step lines (#514)…
scuttletoby Nov 19, 2026
9ae907b
fork report: count review rules, handoff and playtest as fork feature…
scuttletoby Nov 19, 2026
a2055d6
fix(provider-core): npm provider updates into a prefix the server can…
juliusmarminge Nov 19, 2026
7eda04c
docs(fork): list the carry of upstream PR 30302
scuttletoby Nov 19, 2026
24ef80e
fork seam: 360 s for the compile-cache warm step under Rosetta (#514)…
scuttletoby Nov 19, 2026
edad3e5
fork report: say where each feature is on, read the managed policy (#…
scuttletoby Nov 19, 2026
5791ad0
Merge remote-tracking branch 'origin/main' into fix525
scuttletoby Nov 19, 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"
]
}
114 changes: 114 additions & 0 deletions .github/fork-ci-tests.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,114 @@
# 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/pr_queue_laws.test.py ~22s
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-ci/laws/laws.test.py
fork-kit/cleaner/tests/compress.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/scratch.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/queue.test.py ~30s
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