| 1843 | 1843 | | "A workspace's runner groups: which of its repositories may use the runners in each. The default group (every repository) is where runners go when no group is named. Owners only." |
| 1844 | 1844 | | } |
| 1845 | 1845 | | Op::GetRunnerSettings => { |
| 1846 | | − | "Where a workspace's (or a repository's) own g1t jobs run, and whether pull requests from forks may use its self-hosted runners. `agents_on_self_hosted` sends checks and the merge queue to runners with `agent_labels` instead of g1t's sandboxes. A repository's are its workspace's unless it has its own (`inherited`)." |
| 1846 | + | "Where a workspace's (or a repository's) own g1t jobs run, and whether pull requests from forks may use its self-hosted runners. `agents_on_self_hosted` sends pull request checks and merge checks to runners with `agent_labels` instead of g1t's sandboxes. A repository's are its workspace's unless it has its own (`inherited`)." |
| 1847 | 1847 | | } |
| 1848 | 1848 | | Op::CreateRunnerRegistrationToken => { |
| 1849 | 1849 | | "A registration token for `g1t-runner register`, shown once. It lasts an hour and registers any number of runners until then, into `group` (the default group if none) for a workspace, or as a repository's own runners. It can do nothing else. Owners of the workspace, or admins of the repository, signed in or with a person's token; workspace tokens, G1T_TOKEN included, are refused." |
| ⋯ |
| 1857 | 1857 | | Op::UpdateRunnerGroup => "Rename a runner group, or change which repositories may use it. Owners only.", |
| 1858 | 1858 | | Op::DeleteRunnerGroup => "Delete a runner group. Its runners join the default group, which cannot be deleted. Owners only.", |
| 1859 | 1859 | | Op::UpdateRunnerSettings => { |
| 1860 | | − | "Change where g1t's own jobs (checks and the merge queue) run and whether pull requests from forks may use self-hosted runners, for a workspace or one repository. Left out is unchanged; `inherit` drops a repository's own settings. Allowing forks lets anyone who can open a pull request run code on your machines. Owners of the workspace, or admins of the repository." |
| 1860 | + | "Change where g1t's own jobs (pull request checks and merge checks) run and whether pull requests from forks may use self-hosted runners, for a workspace or one repository. Left out is unchanged; `inherit` drops a repository's own settings. Allowing forks lets anyone who can open a pull request run code on your machines. Owners of the workspace, or admins of the repository." |
| 1861 | 1861 | | } |
| 1862 | 1862 | | Op::ImportIssue => { |
| 1863 | 1863 | | "Open an issue from a ticket in Jira or Linear, or from a Sentry issue, by its key or address. The issue is linked to it: agents read the original, and when the work lands the ticket is told. Importing the same ticket again returns the issue already made." |
| ⋯ |
| 3186 | 3186 | | ), |
| 3187 | 3187 | | Op::UpdateRunnerSettings => object( |
| 3188 | 3188 | | runners_owner(json!({ |
| 3189 | | − | "agents_on_self_hosted": { "type": "boolean", "description": "Run checks and the merge queue on self-hosted runners." }, |
| 3189 | + | "agents_on_self_hosted": { "type": "boolean", "description": "Run pull request checks and merge checks on self-hosted runners." }, |
| 3190 | 3190 | | "agent_labels": { |
| 3191 | 3191 | | "type": "array", |
| 3192 | 3192 | | "items": { "type": "string" }, |
| 3193 | | − | "description": "The labels a runner needs to take checks and merge queue work. self-hosted is always one.", |
| 3193 | + | "description": "The labels a runner needs to take pull request checks and merge checks. self-hosted is always one.", |
| 3194 | 3194 | | }, |
| 3195 | 3195 | | "fork_pull_requests": { "type": "boolean", "description": "Let jobs of pull requests from forks run on self-hosted runners." }, |
| 3196 | 3196 | | "inherit": { "type": "boolean", "description": "For a repository: drop its own settings and follow its workspace's." }, |