Skip to content

docs(settings): document that publicSurface doesn't suppress either check-run #5311

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
JSONbored merged 1 commit into from
Jul 12, 2026
+33 −8
Merged

docs(settings): document that publicSurface doesn't suppress either check-run #5311

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions apps/gittensory-ui/public/openapi.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3837,7 +3837,8 @@
"comment_and_label",
"comment_only",
"label_only"
]
],
"description": "Governs ONLY the PR comment and label -- never the Gittensory Context check (checkRunMode) or the Gittensory Orb Review Agent gate check (reviewCheckMode), which are independent axes by design (#2852). Setting this to \"off\" does NOT silence either check-run."
},
"commentMode": {
"type": "string",
Expand Down Expand Up @@ -9211,7 +9212,8 @@
"comment_and_label",
"comment_only",
"label_only"
]
],
"description": "Governs ONLY the PR comment and label -- never the Gittensory Context check (checkRunMode) or the Gittensory Orb Review Agent gate check (reviewCheckMode), which are independent axes by design (#2852). Setting this to \"off\" does NOT silence either check-run."
},
"includeMaintainerAuthors": {
"type": "boolean"
Expand Down Expand Up @@ -9714,7 +9716,8 @@
"comment_and_label",
"comment_only",
"label_only"
]
],
"description": "Governs ONLY the PR comment and label -- never the Gittensory Context check (checkRunMode) or the Gittensory Orb Review Agent gate check (reviewCheckMode), which are independent axes by design (#2852). Setting this to \"off\" does NOT silence either check-run."
},
"commentMode": {
"type": "string",
Expand Down Expand Up @@ -10128,7 +10131,8 @@
"comment_and_label",
"comment_only",
"label_only"
]
],
"description": "Governs ONLY the PR comment and label -- never the Gittensory Context check (checkRunMode) or the Gittensory Orb Review Agent gate check (reviewCheckMode), which are independent axes by design (#2852). Setting this to \"off\" does NOT silence either check-run."
},
"commentMode": {
"type": "string",
Expand Down
24 changes: 20 additions & 4 deletions src/openapi/schemas.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -779,7 +779,11 @@ export const RepositorySettingsSchema = z
gittensorLabel: z.string(),
blacklistLabel: z.string().nullable(),
createMissingLabel: z.boolean(),
publicSurface: z.enum(["off", "comment_and_label", "comment_only", "label_only"]),
publicSurface: z
.enum(["off", "comment_and_label", "comment_only", "label_only"])
.describe(
"Governs ONLY the PR comment and label -- never the Gittensory Context check (checkRunMode) or the Gittensory Orb Review Agent gate check (reviewCheckMode), which are independent axes by design (#2852). Setting this to \"off\" does NOT silence either check-run.",
),
includeMaintainerAuthors: z.boolean(),
requireLinkedIssue: z.boolean(),
backfillEnabled: z.boolean(),
Expand Down Expand Up @@ -859,7 +863,11 @@ export const RepoSettingsPreviewSchema = z
repoFullName: z.string(),
generatedAt: z.string(),
settings: z.object({
publicSurface: z.enum(["off", "comment_and_label", "comment_only", "label_only"]),
publicSurface: z
.enum(["off", "comment_and_label", "comment_only", "label_only"])
.describe(
"Governs ONLY the PR comment and label -- never the Gittensory Context check (checkRunMode) or the Gittensory Orb Review Agent gate check (reviewCheckMode), which are independent axes by design (#2852). Setting this to \"off\" does NOT silence either check-run.",
),
commentMode: z.enum(["off", "detected_contributors_only", "all_prs"]),
publicAudienceMode: z.enum(["oss_maintainer", "gittensor_only"]),
publicSignalLevel: z.enum(["minimal", "standard"]),
Expand Down Expand Up @@ -1258,7 +1266,11 @@ export const InstallationRepairSchema = z
repoFullName: z.string(),
isRegistered: z.boolean(),
settings: z.object({
publicSurface: z.enum(["off", "comment_and_label", "comment_only", "label_only"]),
publicSurface: z
.enum(["off", "comment_and_label", "comment_only", "label_only"])
.describe(
"Governs ONLY the PR comment and label -- never the Gittensory Context check (checkRunMode) or the Gittensory Orb Review Agent gate check (reviewCheckMode), which are independent axes by design (#2852). Setting this to \"off\" does NOT silence either check-run.",
),
commentMode: z.enum(["off", "detected_contributors_only", "all_prs"]),
publicAudienceMode: z.enum(["oss_maintainer", "gittensor_only"]),
checkRunMode: z.enum(["off", "enabled"]),
Expand Down Expand Up @@ -2173,7 +2185,11 @@ export const RegistrationReadinessSchema = z
docsCompleteness: z.record(z.string(), z.unknown()),
githubApp: z.object({
installed: z.boolean(),
publicSurface: z.enum(["off", "comment_and_label", "comment_only", "label_only"]),
publicSurface: z
.enum(["off", "comment_and_label", "comment_only", "label_only"])
.describe(
"Governs ONLY the PR comment and label -- never the Gittensory Context check (checkRunMode) or the Gittensory Orb Review Agent gate check (reviewCheckMode), which are independent axes by design (#2852). Setting this to \"off\" does NOT silence either check-run.",
),
commentMode: z.enum(["off", "detected_contributors_only", "all_prs"]),
publicAudienceMode: z.enum(["oss_maintainer", "gittensor_only"]),
checkRunMode: z.enum(["off", "enabled"]),
Expand Down
5 changes: 5 additions & 0 deletions src/types.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -944,6 +944,11 @@ export type RepositorySettings = {
* settings.advisoryAiRouting` in shared/global or per-repo config. Defaults all-false so every advisory
* capability stays on the shared frontier env.AI chain until an operator opts each one in. */
advisoryAiRouting?: AdvisoryAiRoutingConfig | undefined;
/** Governs ONLY the PR comment and label -- never the "Gittensory Context" check ({@link checkRunMode})
* or the "Gittensory Orb Review Agent" gate check ({@link reviewCheckMode}), which are independent axes
* by design (#2852: the check-run must keep posting for branch-protection/auto-merge to keep working
* even when a maintainer wants full public silence). Setting this to `"off"` does NOT silence either
* check-run -- see README's "Check-run and comment surfaces, disambiguated" section. */
publicSurface: "off" | "comment_and_label" | "comment_only" | "label_only";
includeMaintainerAuthors: boolean;
/** Surfaces the `missing_linked_issue` advisory finding in the review comment -- does NOT block a PR on
Expand Down
Loading