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

1

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

2

import { Suspense } from "react";

3

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

4

5

import { ruleInfo } from "../../lib/rules";

6

7

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

8

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

9

import { AddCiPrompt } from "../../components/add-ci";

10

import { CodeownersReportPanel, CodeownersReportSkeleton } from "../../components/codeowners";

11

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

12

import { EnforcementBadge } from "../../components/rules";

13

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

14

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

15

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

16

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

17

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

18

19

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

20

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

21

}

22

23

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

24

const viewer = getViewer(context);

25

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

26

const { access } = await requireInsider(context, params, "manage_protection");

27

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

28

const [repo, settings, seen, workflows] = await Promise.all([

29

repos.get(path, viewer),

30

work.getSettings(path, viewer),

31

work.seenChecks(path, viewer),

32

actions.workflows(path, viewer),

33

]);

34

const found = unwrap(repo);

35

// What holds for the default branch: shown here, changed in Rules.

36

const effective = await work.effectiveRules(path, found.defaultBranch, viewer).catch(() => null);

37

// Streamed: the CODEOWNERS file is read and checked on its own time.

38

const codeowners = work

39

.codeownersErrors(path, viewer)

40

.then((report) => (report.ok ? report.value : null))

.catch(() => null);

return {

codeowners,

repo: found,

settings: unwrap(settings),

46

effective: effective?.ok ? effective.value : null,

47

// Nothing to require until something runs: the page offers to add CI.

48

noChecks: workflows.ok && workflows.value.length === 0 && seen.ok && seen.value.length === 0,

49

canPush: access.can.push,

};

}

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

54

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

55

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

56

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

57

}

58

59

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

60

assertSameOrigin(request);

61

const user = requireUser(context, request);

62

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

63

const form = await request.formData();

64

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

65

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

66

// Branch protection is the repository's rulesets' (Settings → Rules):

67

// what it holds is sent back as it is, so only how g1t's agents work

68

// changes here.

69

const current = await work.getSettings(path, user);

70

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

71

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

72

...current.value,

73

autoMerge: on("autoMerge"),

74

agentReview: on("agentReview"),

75

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

76

holdLowConfidence: on("holdLowConfidence"),

77

});

78

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

79

}

80

81

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

82

const { repo, settings, effective, noChecks, canPush, codeowners } = loaderData;

83

const branch = repo.defaultBranch;

84

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

85

const archived = Boolean(repo.archivedAt);

86

const active = effective?.rules.filter((rule) => rule.enforcement === "active") ?? [];

87

const labels = [...new Set(active.map((rule) => ruleInfo(rule.type)?.label ?? rule.type))];

return (

<>

{/* Its own form, so outside the settings one. */}

{noChecks && (

</div>

)}

<Section

title="Branch protection"

100

about={`What holds for ${branch} and every other branch is set by rulesets: for people and agents alike, and across the workspace.`}

101

>

102

<Link

103

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

104

className="group flex items-start 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">Rules for {branch}</span>

109

110

{labels.length > 0 ? labels.join(" · ") : `No active rules hold for ${branch}: anyone who may push can change it.`}

111

</span>

112

{effective && effective.rulesets.length > 0 && (

113

114

{effective.rulesets.map((ruleset) => (

115

116

{ruleset.name} <EnforcementBadge enforcement={ruleset.enforcement} />

</span>

))}

</span>

)}

</span>

</Link>

</Section>

<Section

id="codeowners"

title="CODEOWNERS"

about={`Who owns which files, read from ${branch}. Owners are asked to review changes to their files.`}

>

{(report) => <CodeownersReportPanel report={report} base={base} branch={branch} />}

</Await>

</Suspense>

</Section>

<Section

title="g1t"

about="What happens to a pull request g1t makes, from the moment it is ready. Its checks are the same workflows, and the branch's rules hold."

143

>

144

145

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

146

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

</Toggle>

<Choice

name="maxRevisions"

value={settings.maxRevisions}

151

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 a failed check, with what its jobs printed, or to address a

161

review, before g1t stops and the pull request says it needs you. After that, only a required check that

162

still fails holds it.

163

</Choice>

164

165

A pull request g1t made lands without anyone pressing merge once every rule of its branch is met, its

166

required checks included. A ruleset can turn this off for some branches, or ask for a confidence first

167

(Agent auto-merge). With this off, it waits for a member. Pull requests from people and from other agents

always wait.

</Toggle>

<Toggle

name="holdLowConfidence"

172

on={settings.holdLowConfidence}

173

title="Ask a person before merging low-confidence changes"

174

>

175

g1t rates how sure it is of each change an agent finishes, from its required checks, revisions, review,

176

tests, size and guardrails. One it rates low waits for a member to approve it, instead of merging by itself

177

or joining the queue, and shows on Mission control as needing you. A Confidence threshold rule asks for

178

more, branch by branch.

179

</Toggle>

180

<Link

181

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

182

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>

187

188

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

</span>

</span>

</Link>

</Section>

Save settings

</SubmitButton>

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

200

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

201

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

202

203

Last changed by <span className="font-mono">{settings.updatedBy}</span> <TimeAgo at={settings.updatedAt} />

</span>

)}

</div>

</fieldset>

</Form>

</div>

</>

);

}