A fix-loop run names only a repository its team lists, pushes to a public one only where its profile allows, never carries a denied path or a mounted secret, stops at its caps as three red rounds stop it, and has its tokens revoked when its session goes dormant¶
Decision 911 · accepted · 2026-10-16 · issue #147
Issue #147, slice 4, as the maintainer decided it on 2026-10-16: private by default, a path denylist on the profile checked on every push, per-team repository lists (#653), caps, and installation tokens revoked at dormancy.
- Two owners, the stricter holds. The worker profile's
spec.github(a platform admin's) takesallowPublic,denyPaths,maxPushesandmaxRunsbesidepermissions; a team'sgithub(a new column,teams.github, its own administrators' throughadmin.team.update) takesrepositories,max_pushesandmax_runs. Caps are the lower of the two where both are set.GitHub.Policyreads both. Rejected: a policy per repository, which would be a third place to look for one answer; and the team settingallowPublicor the paths, which are what a platform admin decides about where data may go. - Per-team repositories, checked three times. At
session.create(GitHub.repository/3, now with the team), atadmin.trigger.putfor a trigger on a repository, and at every token (GitHub.credential/2, the clone's included), so a repository taken off the list gets nothing from the next token on.owner/name, orowner/*for every repository of the owner; compared without case. A team that lists nothing names nothing, and a session with no team names nothing: an upgrade leaves every team with an empty list until a team admin fills it in, which is the safe direction for a list whose job is to say no. The App's installations still bound it: an owner the App is not installed for is refused whatever a team lists. Rejected: an empty list meaning every repository, which is the behaviour this replaces and would make "lists none" and "never looked" the same answer. - Private by default, asked at push time.
git_pushandpr_openask GitHub for the repository (GET /repos/{owner}/{name}, which every App token may) and refuse when it is public and the profile'sallowPublicis nottrue.privateandinternalpass;public, or an answer that says neither, is refused. Asked at every push rather than remembered from the clone, since a repository can be made public in between; the cost is one read per push. The plane handsallow_publicto the pod in the fix loop's credential (policy), with the rest of what the pod checks. - A path denylist, checked before anything is sent.
Troupe.PushPaths(in the protocol app, since the plane validates patterns and the pod matches them). Defaults that no profile can take away:.env,.env.*,*.pem,*.key,*.p12,*.pfx,id_rsa*,id_dsa*,id_ecdsa*,id_ed25519*. A profile'sdenyPathsadds to them;effective/1starts from the defaults even if the plane sent none. Patterns read as.gitignore's: a name alone at any depth, file or directory; a path with/from the root, with the directories under it;*,?,**; either case, since a case-insensitive checkout makes.ENVthe same file. What is matched is every path the push adds or changes, the tree diff the push would send: a file already on GitHub that the push does not touch is not this push's to refuse, and refusing it would stop every push to a repository that commits an.env.example. A refusal names every path with the pattern that caught it, says how to leave them out (.gitignore, thengit rm --cachedfor one a refused push staged), and no blob, tree, commit or ref is written. A visibility refusal and a path refusal are said together, so a push refused for both is refused for both. - Mounted secrets. The pod's secret directories (
:secret_dirs, by default/var/run/secrets, where its projected tokens are, and the MCP identities) are not in the agent's sandbox, so a copy of one in the tree means something got past that.GitHub.Secretsrefuses a path the push would send that is under one of them, a link into one, or a file whose bytes are a mounted file's: found by comparing git blob names (SHA-1 and SHA-256) with the blob names of the mounted files, so it is exact, costs one hash per mounted file, and copies no secret anywhere. Files under 16 bytes are skipped, being no secret and any other file's name. Limit: a projected token rotates, and a copy of an earlier one no longer matches. - No content scan. Left out on purpose: patterns for "obvious secrets" in what a push carries would be guesses, refuse test fixtures that are keys on purpose, and look like a guarantee they are not. The names above are exact; the content of a push is what GitHub's own secret scanning and push protection are for, which an organisation turns on for its repositories.
- A cap of pushes stops a run as three red rounds stop it. When the record has as many
pushes as the cap and the agent asks for another, the pod records
stop({reason: "pushes"}, which the plane takes only at the cap), the record'sstoppedsaysits cap of N pusheswithcap: "pushes", the bot comments on the draft, the write token is dropped and revoked, and the agent is told to comment what it tried and stop. The plane holds it without the pod: a push recorded past the cap is refused, and a write token minted at the cap hascontents: read. The stop is at the push asked for past the cap rather than at the last one allowed, so the run has a pull request to say it on, and the last push's CI is still counted. - A cap of runs at once.
maxRunson the profile andmax_runson the team count the live runs of triggers on a repository (what a trigger's ownconcurrencycounts as live) on that profile and on that team, across their triggers; a firing over either is recordedskippedwith the reason in the log, as one over a trigger's own concurrency is. Only runs on a repository count: these are the fix loop's caps, and a trigger that does not touch GitHub is not what they bound. The run's budget is checked as before, first, by the session it would start. - Tokens die with their activation.
GitCredentials.forget/2revokes what it drops: each unexpired token goes to GitHub'sDELETE /installation/token, made with the token itself, at the API URL the plane put in it (now in the clone's credential too). It runs when the session's manager stops (dormancy, a stop, a crashed tree), when an activation starts, and when a stop closes pushes; after the caller is answered, in a task, logging the session and the expiry and never the token. A clone-only profile that does not declare the API host cannot revoke its clone token from the pod, and that token runs out on its own. Rejected: the plane revoking them, which would need it to keep every token it minted. -
Inheritance. Under
extends(Decision 908) a parent'sallowPublic: falseholds,denyPathsare added, andmaxPushesandmaxRunsonly narrow. -
The CRD.
spec.githubnames the four keys, so the cluster's admission checks them as the plane does.
Governs: apps/troupe_protocol/lib/troupe/push_paths.ex, apps/troupe_plane/lib/troupe/plane/github/policy.ex, apps/troupe_plane/lib/troupe/plane/github.ex, apps/troupe_plane/lib/troupe/plane/identity/team.ex, apps/troupe_worker/lib/troupe/worker/github.ex, apps/troupe_worker/lib/troupe/worker/github/api.ex, apps/troupe_worker/lib/troupe/worker/github/secrets.ex, apps/troupe_worker/lib/troupe/worker/git_credentials.ex