Skip to main content

Github Repository

GithubRepository​

Defines a managed GitHub repository within a connected organization.

Provisions the repository, its CI/CD workflow files, a .github/CODEOWNERS file, and branch protection rules from the branching strategy. It is the parent of the BuildDefinition manifests.

PropertyTypeDescription
apiVersionstringAPI schema version. Must be lowops.manifests.v1.
kindstringResource kind. Must be GithubRepository.
metadatamapFree-form key/value labels. The engine reads reserved keys (for example name, organization) to resolve the identity of this manifest and its parent GithubConnection.
specSpecDesired repository configuration. See Spec.

BranchConfigEntry​

PropertyTypeDescription
keystring
valueComputedGithubBranchConfig

ComputedCodeOwner​

Resolved code-owner reference (a team or user).

PropertyTypeDescription
idint64Numeric ID of the team or user.
namestringName of the team or user.
isTeamboolTrue for a team, false for an individual user.

ComputedCodeOwnerEntry​

Resolved code-owner assignment for a path pattern.

PropertyTypeDescription
pathstringPath pattern of the owners.
ownerslist of ComputedCodeOwnerResolved owners.

WorkflowsEntry​

PropertyTypeDescription
keystring
valuestring

Spec​

User-provided repository configuration.

Declares the repository, its branching strategy, its access, and its options.

PropertyTypeDescription
publicboolIf true, the repository is public. If false (the default), it is private. AI-assistant features need a private repository.
namestringRepository name on GitHub, verbatim. If omitted, the engine uses metadata.name. The engine adds no prefix. A change renames the repository: the engine archives the old one and creates a new one. It never deletes a repository, and it unarchives one that you adopt again.
descriptionstringOptional free text. The engine copies it to the description of the GitHub repository. AI assistants use it as context.
templatestringName of a GithubRepositoryTemplate to base the repository on. It must exist. The engine resolves it into the computed template_repository, but it does not apply the template at creation yet.
strategystringBranching strategy: GIT_FLOW, GITHUB_FLOW, or TRUNK_BASED. It selects the branch layout and protection rules, and sets the computed default_branch and branch_config.
codeOwnerslist of CodeOwnerEntryPath/owner assignments for the generated .github/CODEOWNERS file, with owners scoped to the connection owner.
pullRequestPullRequestConfigPull request template configuration. See PullRequestConfig. The engine resolves the referenced template into the computed pull_request_template, but it does not write it to .github/pull_request_template.md yet.
licensestringName of a GithubLicense manifest. The engine validates it and resolves its content into the computed license, but it does not write a LICENSE file yet.
permissionsAccessPermissionsUsers and teams with admin, push (contributor), or pull (viewer) access. The engine applies them as repository permissions, and adds them to the code-owner set and the computed permissions (identities resolved to full Cloud Identity identifiers).
configurationConfigurationOptional repository features. See Configuration.
secretslist of stringNames of GithubSecret manifests that the GitHub Actions workflows of the repository can use. Each name binds the repository to the organization-level secret.
aiAssistantAiAssistantOpt in to Gemini-powered assistance (pull request and source documentation). See AiAssistant. Pull request assistance needs a private repository.

AiAssistant​

AI-assistant configuration.

Groups the AI-assistant toggles.

PropertyTypeDescription
pullRequestAiAssistantPullRequestPull request AI-assistant settings. See AiAssistantPullRequest.
sourceIngestionSourceIngestionSource-code ingestion (graphify) settings. See SourceIngestion.
releaseIndexingReleaseIndexingRelease-indexing settings. See ReleaseIndexing.

AiAssistantPullRequest​

AI-assistant pull request settings.

Controls whether the AI assistant helps to document pull requests.

PropertyTypeDescription
enabledboolEnable AI assistance on pull requests. If true and the repository is private, the engine enables Gemini-based pull request documentation.

CodeOwnerEntry​

Code-owner assignment for a repository path.

Links a path pattern to its owners. The entries generate the .github/CODEOWNERS file.

PropertyTypeDescription
pathstringA .github/CODEOWNERS path pattern, for example /docs or *.go.
ownerslist of stringGitHub team slugs or user handles that own the paths. The engine renders them as @owner/team entries scoped to the connection owner.

Configuration​

GitHub repository feature toggles.

Enables or disables optional GitHub features.

PropertyTypeDescription
wikiboolEnable the repository wiki (HasWiki).
projectsboolEnable GitHub Projects (HasProjects).
issuesboolEnable the issue tracker (HasIssues).
downloadsboolNOT YET IMPLEMENTED. The engine ignores this field.

PullRequestConfig​

Pull request template selection and merge requirements.

References the GithubPullRequestTemplate and sets what the gated branches (main, develop, GIT_FLOW releases) require before a merge. The requirements never affect feature, hotfix, and TRUNK_BASED release branches.

PropertyTypeDescription
templatestringName of a GithubPullRequestTemplate manifest. Its Markdown content goes into the computed pull_request_template. An unresolvable name gives empty content.
requiredApprovalsint32Number of approvals that a gated branch requires before a merge. Unset keeps the default of 1. 0 leaves approval to the code owners alone, who still must approve any change to a path they own. 0 is valid only if all of these are true. First, code_owners owns .github/** in its LAST entry, because the last CODEOWNERS entry that matches a path wins. Second, no code_owners entry lacks owners or has whitespace or # ! [ ] \\ in its path. Third, required_checks pins at least one check to an app other than GitHub Actions.
requiredCheckslist of RequiredCheckExtra checks that a gated branch requires after Merge Authorized, each pinned to its app. Use them to make an external verifier binding. Rulesets only: classic branch protection cannot pin a check to an app.

RequiredCheck​

Status check that a gated branch requires, pinned to its GitHub App.

GitHub counts a check only from its pinned app. A check without a pin is advice: any workflow that posts the same name satisfies it.

PropertyTypeDescription
contextstringCheck run or status context name, exactly as GitHub reports it. Must not be Merge Authorized, which the engine already requires on every gated branch and pins to GitHub Actions.
appIdint64Numeric ID of the GitHub App that posts the check. Must be positive. Checks from other apps do not count.

ReleaseIndexing​

Release-indexing settings.

Controls the code index of the releases. The index says which code each workload runs in each environment.

PropertyTypeDescription
enabledboolEnable release indexing. If true, Infrastream indexes the code that each workload of the repository runs, in the environments below. The index holds file paths, symbol names and the shape of the call graph. This field is also the consent of the repository owner: every person with the tier contributor or higher in the company can read that structure. The engine rejects it on public repositories.
environmentslist of stringNames of Environment manifests in which Infrastream indexes the code. If empty, the engine uses the environments of the stages of the release tracks of the repository, except each environment where a Project has RSI on and lists the repository in spec.rsi.repositories. A name must be unique. The engine rejects a list when enabled is false.

SourceIngestion​

Source-code ingestion (graphify) settings.

Controls graphify knowledge-graph ingestion for this repository.

PropertyTypeDescription
enabledboolEnable graphify source ingestion. If true, the engine registers the repository: each push to the default branch re-ingests the source (incrementally) into the graphify-out bucket. The engine ignores it on public repositories.

AccessPermissions​

Administrator, contributor, and viewer privileges for an asset.

The engine aggregates the users and groups into IAM policies.

PropertyTypeDescription
administratorsDetailedAccessPermissionsUsers and groups with administrative privileges, usually full control.
contributorsDetailedAccessPermissionsUsers and groups with contributor privileges, usually read and write access.
viewersDetailedAccessPermissionsUsers and groups with viewer privileges, usually read-only access.

ComputedGithubBranchConfig​

Computed branch protection rules for a GitHub repository.

They set review counts, status checks and bypass roles.

PropertyTypeDescription
idstringUnique identifier of the rule set, for example primary-branches.
targetPatternslist of stringGlob patterns of the branches that the rules apply to, for example main or feat/*.
requiredReviewersint64Number of approvals that a pull request needs before merge.
canCreateboolWhether users can create branches that match these patterns.
bypassRoleslist of stringGitHub roles, for example Maintainer or Admin, that can bypass the rules.
statusCheckslist of stringStatus check contexts that must pass before merge.
releaseTypestringRelease type of the branch, for example major, minor or patch. It can influence versioning automation.
allowedSourceBranchPatternslist of stringGlob patterns of the branches that can merge into this branch. CI uses them to enforce the flow.
requiredBranchPatternstringOptional regex that the branches in target_patterns must match.
allowedMergeMethodslist of stringAllowed merge methods, for example merge, squash or rebase.
statusCheckAppslist of StatusCheckAppsEntryGitHub App for each required status check, keyed by check name. GitHub counts a check only when this app posts it. The engine pins a check that is not in the map to its own app.

DetailedAccessPermissions​

User and group access definitions.

The engine resolves the listed manifests to Google Workspace identity emails for IAM bindings.

PropertyTypeDescription
memberslist of stringNames of OrganizationUser manifests.
groupslist of stringNames of OrganizationUserGroup manifests.

StatusCheckAppsEntry​

PropertyTypeDescription
keystring
valueint64