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.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be GithubRepository. |
| metadata | map | Free-form key/value labels. The engine reads reserved keys (for example name, organization) to resolve the identity of this manifest and its parent GithubConnection. |
| spec | Spec | Desired repository configuration. See Spec. |
BranchConfigEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | ComputedGithubBranchConfig |
ComputedCodeOwner
Resolved code-owner reference (a team or user).
| Property | Type | Description |
|---|---|---|
| id | int64 | Numeric ID of the team or user. |
| name | string | Name of the team or user. |
| isTeam | bool | True for a team, false for an individual user. |
ComputedCodeOwnerEntry
Resolved code-owner assignment for a path pattern.
| Property | Type | Description |
|---|---|---|
| path | string | Path pattern of the owners. |
| owners | list of ComputedCodeOwner | Resolved owners. |
WorkflowsEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | string |
Spec
User-provided repository configuration.
Declares the repository, its branching strategy, its access, and its options.
| Property | Type | Description |
|---|---|---|
| public | bool | If true, the repository is public. If false (the default), it is private. AI-assistant features need a private repository. |
| name | string | Repository 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. |
| description | string | Optional free text. The engine copies it to the description of the GitHub repository. AI assistants use it as context. |
| template | string | Name 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. |
| strategy | string | Branching 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. |
| codeOwners | list of CodeOwnerEntry | Path/owner assignments for the generated .github/CODEOWNERS file, with owners scoped to the connection owner. |
| pullRequest | PullRequestConfig | Pull 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. |
| license | string | Name 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. |
| permissions | AccessPermissions | Users 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). |
| configuration | Configuration | Optional repository features. See Configuration. |
| secrets | list of string | Names of GithubSecret manifests that the GitHub Actions workflows of the repository can use. Each name binds the repository to the organization-level secret. |
| aiAssistant | AiAssistant | Opt 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.
| Property | Type | Description |
|---|---|---|
| pullRequest | AiAssistantPullRequest | Pull request AI-assistant settings. See AiAssistantPullRequest. |
| sourceIngestion | SourceIngestion | Source-code ingestion (graphify) settings. See SourceIngestion. |
| releaseIndexing | ReleaseIndexing | Release-indexing settings. See ReleaseIndexing. |
AiAssistantPullRequest
AI-assistant pull request settings.
Controls whether the AI assistant helps to document pull requests.
| Property | Type | Description |
|---|---|---|
| enabled | bool | Enable 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.
| Property | Type | Description |
|---|---|---|
| path | string | A .github/CODEOWNERS path pattern, for example /docs or *.go. |
| owners | list of string | GitHub 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.
| Property | Type | Description |
|---|---|---|
| wiki | bool | Enable the repository wiki (HasWiki). |
| projects | bool | Enable GitHub Projects (HasProjects). |
| issues | bool | Enable the issue tracker (HasIssues). |
| downloads | bool | NOT 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.
| Property | Type | Description |
|---|---|---|
| template | string | Name of a GithubPullRequestTemplate manifest. Its Markdown content goes into the computed pull_request_template. An unresolvable name gives empty content. |
| requiredApprovals | int32 | Number 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. |
| requiredChecks | list of RequiredCheck | Extra 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.
| Property | Type | Description |
|---|---|---|
| context | string | Check 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. |
| appId | int64 | Numeric 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.
| Property | Type | Description |
|---|---|---|
| enabled | bool | Enable 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. |
| environments | list of string | Names 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.
| Property | Type | Description |
|---|---|---|
| enabled | bool | Enable 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.
| Property | Type | Description |
|---|---|---|
| administrators | DetailedAccessPermissions | Users and groups with administrative privileges, usually full control. |
| contributors | DetailedAccessPermissions | Users and groups with contributor privileges, usually read and write access. |
| viewers | DetailedAccessPermissions | Users 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.
| Property | Type | Description |
|---|---|---|
| id | string | Unique identifier of the rule set, for example primary-branches. |
| targetPatterns | list of string | Glob patterns of the branches that the rules apply to, for example main or feat/*. |
| requiredReviewers | int64 | Number of approvals that a pull request needs before merge. |
| canCreate | bool | Whether users can create branches that match these patterns. |
| bypassRoles | list of string | GitHub roles, for example Maintainer or Admin, that can bypass the rules. |
| statusChecks | list of string | Status check contexts that must pass before merge. |
| releaseType | string | Release type of the branch, for example major, minor or patch. It can influence versioning automation. |
| allowedSourceBranchPatterns | list of string | Glob patterns of the branches that can merge into this branch. CI uses them to enforce the flow. |
| requiredBranchPattern | string | Optional regex that the branches in target_patterns must match. |
| allowedMergeMethods | list of string | Allowed merge methods, for example merge, squash or rebase. |
| statusCheckApps | list of StatusCheckAppsEntry | GitHub 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.
| Property | Type | Description |
|---|---|---|
| members | list of string | Names of OrganizationUser manifests. |
| groups | list of string | Names of OrganizationUserGroup manifests. |
StatusCheckAppsEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | int64 |