Sign in

Search issue titles and bodies, change requests and comments. Private repositories you cannot read are not included.

vole
Clone

Read only, no credentials:

https://rodent.software/git/vole.git

Write over SSH with a registered key:

git clone ssh://git@0.0.0.0:2222/vole.git

A free and open-source forge that lives in your Git repo.

Let an account be a bot

29a795b9d5b79cf5c8f2b7f3b4f6572f7cdff444 · Keenan Nemetz · 6d ago · parent e7aa0785

Let an account be a bot

An automation needs an identity: something to assign an issue to, mention in a
comment, and name in an approval and the audit log. An account already gives all
of that, so this adds only the invariants a bot needs and the word for it.

A bot is created with `vole admin account create --bot`, with the repository role
the admin decides it should have. It has no browser sign-in — `account invite` and
adding a passkey are refused — and it cannot hold the instance-admin role, because
Admin reaches every repository and every instance surface while a bot is a
repository automation. It is marked as a bot in the user directory and on its
profile.

Everything else is deliberately unchanged. A bot obeys the rules of its role: a
contribute bot pushes only its own contributor branch and its CI waits for a
maintainer to allow the tip; a maintain bot pushes shared branches, runs CI
immediately, and its approval counts. The kind is fixed at creation, like the name,
and a roster that predates it reads every account as a person.

This is the first of three slices of #165. The per-run credential that lets a
workflow act as a bot without a long-lived key in a repository secret is next; this
slice changes no push rule and no permission.

docs/workflows.md +4

@@ -177,6 +177,10 @@ not start it again. Mentions inside code samples are ignored. See
177 177 [Workflow reference § Event filters](reference/workflow-reference.md#event-filters)
178 178 for the exact rules.
179 179
180 The job acts as an account, so the account it uses should be a bot: it has no
181 browser sign-in and is shown as a bot wherever its name appears. See
182 [Accounts and access § Bot accounts](accounts-and-access.md#bot-accounts).
183
180 184 A comment body is still untrusted text. If the job can write — comment, push a
181 185 branch, or open a change — use `author.role: maintain` or `author.name` to limit who can
182 186 start it, or rely on assignment, which requires triage. Read the agent's