config.yaml.template

# OpenGiraffe Configuration
# Copy this file to config.yaml and edit the values below.

# Target repository to work on
repo:
  path: /path/to/your/repository
  # Base branch for creating worktrees
  base_branch: master
  # Directory to store worktrees (absolute path recommended)
  worktree_dir: /path/to/OpenGiraffe/worktrees
  # Scripts to run inside the worktree after it is created (relative to repo root or absolute).
  # They are executed in order; a non-zero exit code aborts the task with an error.
  # Example: a script that builds compile_commands.json or installs project dependencies.
  worktree_hooks: []
  #  - hooks/setup_worktree.sh

# OpenCode settings
opencode:
  # Passed to opencode as OPENCODE_CONFIG. Relative paths are resolved from this repo.
  config_path: opencode.json
  # Model for planning tasks (complexity assessment, sub-task splitting)
  planner:
    model: your-provider/planner-model
    # variant is optional, can be omitted for all models
    variant: ""
  planner_model: your-provider/planner-model
  # Coder model selected by task complexity (planner assigns one of: very_complex/complex/medium/simple)
  coder_default:
    model: your-provider/balanced-model
  coder_model_by_complexity:
    very_complex:
      model: your-provider/strongest-model
    complex:
      model: your-provider/strongest-model
    medium:
      model: your-provider/balanced-model
    simple:
      model: your-provider/fast-model
  # Fallback coder model if complexity is unrecognised
  coder_model_default: your-provider/balanced-model
  # Reviewer models — ALL must approve for a task to pass
  # Using multiple diverse models improves review quality
  reviewers:
    - model: your-provider/reviewer-model-1
    - model: your-provider/reviewer-model-2
  reviewer_models:
    - your-provider/reviewer-model-1
    - your-provider/reviewer-model-2
  # Timeout in seconds for a single opencode run
  timeout: 3600

# Orchestrator settings
orchestrator:
  # Max parallel tasks (each gets its own worktree)
  max_parallel_tasks: 3
  # Max coding retries after review requests changes (total attempts = max_retries + 1)
  max_retries: 4
  # Polling interval in seconds
  poll_interval: 30
  # Auto-scan for TODOs on startup
  auto_scan_todos: false

# Environment variables injected into every worktree hook script
hook_env: {}
#  ROOT_WORKSPACE_PATH: /path/to/your/repository

# Web dashboard
web:
  host: 0.0.0.0
  port: 8778

# Repository publish settings (used by the Publish button)
publish:
  # Remote to push completed branches to
  remote: origin

# Code exploration system
explore:
  explorer:
    model: your-provider/explorer-model
  # Model for map initialization and exploration agents
  map:
    model: your-provider/explorer-model
  explorer_model: your-provider/explorer-model
  map_model: your-provider/explorer-model
  # Max exploration runs executing at once (overflow goes to queue)
  max_parallel_runs: 2
  # Categories to explore per module
  categories:
    - performance
    - concurrency
    - error_handling
    - maintainability
    - security
  # Auto-create tasks for findings at or above this severity (critical/major/minor/info)
  auto_task_severity: major

# Jira issue creation mode
jira:
  # Jira base URL and token are exported to the vendored skill as JIRA_URL/JIRA_TOKEN
  url: https://your-jira.example.com
  token: your-jira-token
  # Optional for basic auth flows used by the skill
  user: ""
  project_key: YOURPROJECT
  epic: YOURPROJECT-12345
  # Candidate values passed to the drafting model; it must choose from these.
  issue_type: ["Bug", "New Feature", "Improvement", "Task"]
  priority: ["Highest", "High", "Medium", "Low", "Lowest"]
  # Relative path inside this repo to the vendored jira-issue skill
  skill_path: skills/jira-issue
  timeout: 120
  # Routing hints passed directly to the simple coder model.
  # Include a catch-all unmatched item if you want fallback assignee/component behavior.
  # labels and component are both optional on each hint.
  # Every created issue will always include the fixed label: DorisExplorer.
  routing_hints:
    - about: query execution issues in be/src/exec and be/src/pipeline
      assignee: your-jira-username
      component: query execution
      labels:
        - query-execution
    - about: all unmatched items
      assignee: your-default-jira-username
      # component is optional
      # labels are optional

# Regression framework profiles
# These profiles are only consumed by the standalone regression framework.
# They are expanded into the normal opencode/explore config fields inside a
# temporary generated config so production settings stay untouched.
regression:
  default_profile: free
  # When true, regression Jira runs inject a dry-run mode into the vendored skill.
  # The main program still drives the full Jira assignment flow end-to-end.
  dry_run_jira: false
  model_profiles:
    free:
      planner_model: opencode/qwen3.6-plus-free
      coder_model_default: opencode/qwen3.6-plus-free
      coder_model_by_complexity: {}
      reviewer_models:
        - opencode/qwen3.6-plus-free
      explorer_model: opencode/qwen3.6-plus-free
      map_model: opencode/qwen3.6-plus-free
      timeout: 1800

# Logging
logging:
  level: INFO
  file: /path/to/OpenGiraffe/logs/agent.log

# Persistence
database:
  path: /path/to/OpenGiraffe/data/tasks.db