GitLab MR review configuration
These settings belong to the GitLab connector. Process environment variables take precedence over a local .env file.
Connections
| Variable | Default | Purpose |
|---|---|---|
GITLAB_BASE_URL | required | GitLab base URL |
GITLAB_TOKEN | required | Bot API token for publication and reviewer management. Not sent to the sandbox |
ORPHEUS_BASE_URL | required | Orpheus API base URL without /api/v1 |
ORPHEUS_API_KEY | required | Service Bearer key accepted by Orpheus |
ORPHEUS_WEB_BASE_URL | ORPHEUS_BASE_URL | Public web base URL for session links |
WORKFLOWS_DIR | workflows | Directory of workflow files, relative to the process working directory unless absolute |
Process and limits
| Variable | Default | Purpose |
|---|---|---|
APP_MODE | prod | prod or dev |
LOG_LEVEL | error | Log verbosity. Use info for operation diagnostics |
HTTP_TIMEOUT_SECONDS | 30 | Timeout of an individual HTTP request |
POLL_INTERVAL_SECONDS | 30 | GitLab polling interval |
SHUTDOWN_TIMEOUT_SECONDS | 20 | Graceful shutdown budget |
RUN_TIMEOUT_SECONDS | 3600 | Agent run timeout |
HOOK_TIMEOUT_SECONDS | 300 | Session hook timeout |
MAX_SESSION_REQUEST_BYTES | 1048576 | Maximum bytes per workflow file and assembled session request. Range: 1–16777216 |
RECONCILE_WORKER_COUNT | 4 | Concurrent reconciliation tasks. Range: 1–64 |
RECONCILE_QUEUE_CAPACITY | 128 | Reconciliation queue capacity. Range: 1–4096 |
MAX_CONCURRENT_REVIEWS | 4 | Concurrent reviews. Range: 1–1024. Constrained by Orpheus capacity as well |
All *_SECONDS settings accept positive integer seconds. Base URLs must use HTTP or HTTPS without embedded credentials, query parameters or fragments. Repository cloning in the sandbox requires HTTPS.
Workflow fields
| Field | Default | Purpose |
|---|---|---|
id | required | Stable unique workflow ID matching [a-z0-9][a-z0-9_-]{0,79} |
project_ids | omitted | Nonempty list of unique positive GitLab project IDs. Omit for the fallback |
profile | required | Existing Orpheus profile |
model | profile | Optional model override |
sandbox_template | required | Existing sandbox template |
services | required | Explicit list of unique service codes. [] is allowed |
language | omitted | Language tag, such as en, ru or pt-BR, for agent-authored text |
notes.success / notes.fail | English defaults | Markdown templates for completion and failure notes. Each field is optional |
A nonempty Markdown review policy is required below the YAML. It replaces the profile instructions. See examples and routing.
Note placeholders
| Placeholder | Value |
|---|---|
{{ .FindingsCount }} | Confirmed finding count on success, including zero |
{{ .Reason }} | Public Orpheus error message when available, otherwise an allowlisted application failure description. Markdown, HTML and mentions are escaped. |
{{ .SessionURL }} | Public session URL on failure, or an empty string when unavailable |
The public Orpheus error message can contain the original harness error and is visible to readers of the MR. To omit error text, set a custom notes.fail without {{ .Reason }}. The connector does not append raw connector errors or hook logs.
Functions, conditions and other expressions are not supported. Explicitly blank fields, unknown substitutions and templates that can render an empty note are rejected. language does not translate templates or failure reasons.
File validation
The connector reads regular UTF-8 .md files at the directory root. Subdirectories, hidden files, names beginning with # and other extensions are skipped. IDs must be unique, project routes must not overlap, and at most one fallback is allowed. Nonregular or non-UTF-8 .md files, unknown fields, invalid YAML, an empty directory or an oversized file prevent the entire service from starting.
Workflows are loaded at startup. See how to apply changes.