apps/web/app/routes/repo/settings-branches.tsx · flagon-io/g1t

1

import { ChevronRight, ShieldCheck } from "lucide-react";

2

import { Form, Link, useNavigation } from "react-router";

3

4

import type { Route } from "./+types/settings-branches";

5

import { page } from "../../lib/meta";

6

import { RepoSettingsHeading } from "../../components/repo-settings-heading";

7

import { SettingChoice as Choice, SettingsSection as Section, SettingToggle as Toggle } from "../../components/settings-section";

8

import { Button, ErrorText, TimeAgo } from "../../components/ui";

9

import { repos, work } from "../../lib/services.server";

10

import { assertSameOrigin, getViewer, requireUser, unwrap } from "../../lib/session.server";

11

import { requireCapability, requireInsider } from "../../lib/access.server";

12

13

export function meta({ params, ...args }: Route.MetaArgs) {

14

return page(args, { title: `Branches and merging · ${params.owner}/${params.repo} · g1t` });

15

}

16

17

export async function loader({ params, context }: Route.LoaderArgs) {

18

const viewer = getViewer(context);

19

// Maintain and up; to anyone without a role here the page does not exist.

20

await requireInsider(context, params, "manage_protection");

21

const path = { namespace: params.owner, name: params.repo };

22

const [repo, settings] = await Promise.all([repos.get(path, viewer), work.getSettings(path, viewer)]);

23

return { repo: unwrap(repo), settings: unwrap(settings) };

24

}

25

26

/** A whole number from a form field, kept within `min` and `max`. */

27

function count(value: FormDataEntryValue | null, min: number, max: number): number {

28

const number = Math.trunc(Number(value));

29

return Number.isFinite(number) ? Math.min(Math.max(number, min), max) : min;

30

}

31

32

export async function action({ request, params, context }: Route.ActionArgs) {

33

assertSameOrigin(request);

34

const user = requireUser(context, request);

35

await requireCapability(context, params, "manage_protection");

36

const form = await request.formData();

37

const path = { namespace: params.owner, name: params.repo };

38

const on = (name: string) => form.get(name) === "on";

39

// Protection belongs to the repository and how its pull requests are

40

// handled to the work service; the page is one form over both.

41

const repo = await repos.update(user, path, { protected: on("protected") });

42

if (!repo.ok) return { saved: false, error: repo.error.message };

43

const settings = await work.updateSettings(user, path, {

44

autoMerge: on("autoMerge"),

45

requireUpToDate: on("requireUpToDate"),

46

requiredApprovals: count(form.get("requiredApprovals"), 0, 6),

47

countAgentApprovals: on("countAgentApprovals"),

48

allowIgnoringChecks: !on("requireChecks"),

49

agentReview: on("agentReview"),

50

maxRevisions: count(form.get("maxRevisions"), 0, 5),

51

mergeQueue: on("mergeQueue"),

52

});

53

return settings.ok ? { saved: true, error: null } : { saved: false, error: settings.error.message };

54

}

55

56

export default function BranchSettings({ loaderData, actionData }: Route.ComponentProps) {

57

const { repo, settings } = loaderData;

58

const saving = useNavigation().state === "submitting";

59

const branch = repo.defaultBranch;

60

const base = `/${repo.namespace}/${repo.name}`;

61

const archived = Boolean(repo.archivedAt);

return (

<>

Pushing to {branch} is refused, for members and agents alike, and git says why. Changes reach it only by

70

merging a pull request. The first push to an empty repository is still allowed.

71

</Toggle>

72

<Choice

73

name="requiredApprovals"

74

value={settings.requiredApprovals}

75

title="Required approvals"

options={[

[0, "None"],

[1, "1"],

[2, "2"],

[3, "3"],

]}

>

How many reviewers must approve before a pull request can merge. A reviewer who has since asked for

84

changes blocks it, and nobody approves their own.

85

</Choice>

86

87

With this off, required approvals have to come from people, and an agent's review is advice.

88

</Toggle>

89

90

With this off, a member can choose to merge although the issue's checks failed or have not finished. With

it on, nobody can.

</Toggle>

<Toggle

name="requireUpToDate"

95

on={settings.requireUpToDate}

96

title="Require pull requests to be up to date before merging"

97

>

98

With this off, a pull request can be merged after {branch} has moved: g1t brings it up to date as part of

99

merging, and asks you only if there is a conflict it cannot resolve. With it on, it has to catch up first

100

and its checks run again on the result, so what lands is exactly what was checked.

101

</Toggle>

102

103

Merging adds a pull request to the queue instead of changing {branch} at once. g1t tests it together with

104

every pull request ahead of it, several combinations at a time, and {branch} only ever moves to a

105

combination whose checks passed. One that fails leaves the queue and goes back to its author, and the ones

106

behind it are tested again without it.

</Toggle>

</Section>

<Section

title="g1t agents"

about="What happens to a pull request a g1t agent makes, from the moment it is ready."

113

>

114

115

A different agent reads each change and posts comments on lines, a summary and a verdict. If it asks for

116

changes, the author is sent back to make them. With this off, review is left to people.

</Toggle>

<Choice

name="maxRevisions"

value={settings.maxRevisions}

121

title="Revisions before asking you"

options={[

[0, "None"],

[1, "1"],

[2, "2"],

[3, "3"],

[5, "5"],

]}

>

How many times an agent is sent back to fix failed checks or address a review before g1t stops and the

131

pull request says it needs you.

132

</Choice>

133

134

A g1t agent's pull request lands without anyone pressing merge once every rule above is met. With this

135

off, it waits for a member. Pull requests from people and from other agents always wait.

136

</Toggle>

137

<Link

138

to={`${base}/settings/guardrails`}

139

className="group flex items-center gap-3 rounded-xl border border-line p-4 transition-colors hover:border-line-strong hover:bg-surface"

>

<span className="block text-sm font-medium">Guardrails</span>

144

145

What agents may reach, run and spend while they work on this repository.

</span>

</span>

</Link>

</Section>

{saving ? "Saving…" : "Save settings"}

155

</Button>

156

{actionData?.saved && <span className="text-sm text-muted">Saved.</span>}

157

<ErrorText>{actionData?.error}</ErrorText>

158

{settings.updatedBy && settings.updatedAt && !actionData && (

159

160

Merge rules last changed by <span className="font-mono">{settings.updatedBy}</span>{" "}

</span>

)}

</div>

</fieldset>

</Form>

</>

);

}