config.yaml.example

# RelEasy config.yaml — stable settings for one project.
# What to port lives in the session file (see session.yaml.example).
# Full reference: docs/configuration.md

# ── Identity (required) ─────────────────────────────────────────────
name: antalya-26.3                  # slug [A-Za-z0-9._-]{1,64}; keys the state file + lock
project: antalya                    # used in branch names and PR titles

origin:
  remote: https://github.com/Altinity/ClickHouse.git
  remote_name: origin

target_branch: antalya-26.3         # base branch (must exist on origin); unset = derive from --onto

# session_file: sessions/antalya-26.3.session.yaml   # default <config-dir>/<target_branch>.session.yaml
# work_dir: /path/to/ClickHouse     # default: cwd
# log_file: .releasy/releasy.log    # append transcript + INFO logs

# ── Behaviour ───────────────────────────────────────────────────────
# push: true                        # push branches and open PRs (default false)
# sequential: false                 # one PR per run, gated on the previous merging
# update_existing_prs: false        # overwrite title/body of an existing rebase PR
# merged_label: port-antalya        # add on merged rebase PR, strip from source PRs
# merged_label_color: "8B5CF6"

# upstream:                         # fetch-only; prerequisite detection
#   remote: https://github.com/ClickHouse/ClickHouse.git
#   remote_name: upstream
#   branch: master

# pr_policy:
#   if_exists: skip                 # skip | recreate | append (branch without a rebase PR)
#   auto_pr: true                   # open a PR for each pushed branch
#   retry_failed: true              # re-process `conflict` entries
#   recreate_closed_prs: false      # re-port closed PRs on a renumbered branch
#   recreate_reverted_prs: false    # same, for `reverted` entries
#   detect_superseded: true         # mark ports already cherry-picked elsewhere
#   honor_stall_reasons: true       # skip units stalled on something external
#   max_partial_continue_attempts: 2  # resumes of a partially applied group; 0 disables

# ── GitHub Project board (needs push: true) ─────────────────────────
notifications:
  github_project: https://github.com/orgs/Altinity/projects/1
  # assignee_dev_options: ["Octo Cat"]  # options when the field is first created
  # assignee_qa_options: ["Verified by Dev"]
  # assignee_dev_login_map:         # GitHub login → Assignee Dev option
  #   octocat: "Octo Cat"

# ── AI: shared ──────────────────────────────────────────────────────
# ai_backend: cli                   # cli | codex | api
# ai_model: opus                    # every AI call; ignored by codex
# ai_effort: high                   # low | medium | high | xhigh | max

# ai_api:                           # ai_backend: api
#   api_key_env: ANTHROPIC_API_KEY
#   # api_key: sk-ant-...           # used only if the env var is unset
#   # base_url: https://my-gateway
#   model: claude-opus-5            # overrides ai_model
#   max_tokens: 64000
#   max_turns: 300
#   thinking: true
#   max_retries: 5
#   request_timeout_seconds: 1800
#   bash_timeout_seconds: 3600
#   tool_output_max_chars: 30000
#   # system_prompt_extra: "Project-specific guidance."

# ai_codex:                         # ai_backend: codex
#   command: codex
#   model: gpt-5.5
#   reasoning_effort: high
#   extra_args: []

# ── AI conflict resolver ────────────────────────────────────────────
# ai_resolve:
#   enabled: false
#   command: claude
#   # allowed_tools: [Read, Edit, Write, Glob, Grep, "Bash(git:*)"]
#   # extra_args: []
#   timeout_seconds: 7200
#   build_command: cd build && ninja
#   deterministic_build: true       # AI resolves; RelEasy builds + runs tests
#   max_build_attempts: 5
#   max_verify_resume_attempts: 2   # 0 disables resuming build_failed branches
#   max_resume_base_drift: 50       # 0 disables
#   max_verify_iterations: 12
#   build_log_tail_lines: 500
#   build_timeout_seconds: 7200
#   run_pr_tests: true
#   test_file_globs:
#     - "tests/queries/**"
#     - "tests/integration/**"
#     - "src/**/tests/**"
#     - "**/gtest_*"
#     - "**/*_test.cpp"
#   test_timeout_seconds: 3600
#   max_iterations: 5               # only with deterministic_build: false
#   max_dead_end_attempts: 2        # 0 = no cap
#   split_conflict_commit: true
#   prompt_file: prompts/resolve_conflict.md
#   merge_prompt_file: prompts/resolve_merge_conflict.md
#   split_prompt_file: prompts/resolve_conflict_split.md
#   resolve_only_prompt_file: prompts/resolve_conflict_nobuild.md
#   fix_build_prompt_file: prompts/fix_build.md
#   run_tests_prompt_file: prompts/run_tests.md
#   api_retries: 3
#   api_retry_backoff_seconds: 15
#   wait_on_session_exhaustion: true
#   session_exhaustion_max_wait_hours: 60
#   session_exhaustion_poll_minutes: 30
#   # session_exhaustion_extra_patterns: ["your balance is too low"]
#   postcondition_retries: 2
#   warn_on_unfixed_postconditions: true
#   auto_add_prerequisite_prs:      # or a bool
#     enabled: false
#     max_prereq_depth: 7
#     require_origin_prereq_label: true
#   verify_resolution: false        # read-only audit of each resolution
#   verify_prompt_file: prompts/verify_resolution.md
#   verify_timeout_seconds: 1800
#   label: ai-resolved
#   label_color: "8B5CF6"
#   needs_attention_label: ai-needs-attention
#   needs_attention_label_color: "D93F0B"
#   missing_prereqs_label: missing-prerequisites
#   missing_prereqs_label_color: "E4E669"
#   auto_prereq_label: auto-prereq-added
#   auto_prereq_label_color: "0E8A16"
#   verify_label: ai-needs-verify
#   verify_label_color: "FBCA04"

# ── AI changelog for multi-PR groups ────────────────────────────────
# ai_changelog:
#   enabled: false
#   command: claude
#   prompt_file: prompts/synthesize_changelog.md
#   timeout_seconds: 300
#   max_pr_body_chars: 3000

# ── Review response (refresh --address-review) ──────────────────────
# review_response:
#   trusted_associations: [OWNER, MEMBER, COLLABORATOR, CONTRIBUTOR]
#   trusted_reviewers: [alice]      # extra trusted logins
#   reply_to_non_addressable: true
#   post_summary_comment: false
#   command: claude
#   prompt_file: prompts/address_review.md
#   max_iterations: 15
#   timeout_seconds: 7200
#   # allowed_tools: [Read, Edit, "Bash(git:*)"]
#   # extra_args: []

# ── CI triage (analyze-fails / refresh --analyze-fails) ─────────────
# analyze_fails:
#   categories: []                  # empty = all failed checks
#   job_level_failures: true
#   baseline_check: true
#   baseline_scan_commits: 25
#   verify_outcome: true
#   max_investigation_rounds: 2
#   verify_prompt_file: prompts/verify_analysis.md
#   verify_timeout_seconds: 1800
#   verify_label: ai-needs-verify
#   verify_label_color: "FBCA04"
#   command: claude
#   prompt_file: prompts/analyze_fails.md
#   timeout_seconds: 7200
#   max_iterations: 6
#   max_prs_per_run: 0              # 0 = no cap
#   flaky_elsewhere_threshold: 2    # 0 disables
#   flaky_check_prs: 12
#   post_comment_to_pr: true
#   # allowed_tools:                # {work_dir} resolves to the repo path
#   #   - Read
#   #   - Bash(git:*)
#   #   - Bash({work_dir}/build/programs/clickhouse:*)
#   # extra_args: []

# ── Dependency graph (graph discover / update / sync) ───────────────
# graph:
#   trusted_associations: [OWNER, MEMBER, COLLABORATOR]
#   trusted_reviewers: [alice]
#   issue_labels: [releasy]         # target-branch name is always added
#   post_comment: true
#   sync_progress: true             # graph sync after run / refresh
#   apply_exclusions: true          # vetoes → exclude_prs
#   minimize_addressed_comments: true
#   command: claude
#   prompt_file: prompts/adjust_graph.md
#   timeout_seconds: 7200
#   # extra_args: []