Skip to content

Generic Bot Configuration - Migration Plan

Open
No due date
•Last updated Aug 31, 2026

Goal
Make the bot fully configuration-driven. Repo-specific behavior is read from coqbot-config.toml; onboarding a new repo should not require source changes.

Status

Done:

In review:

Milestone details

M1 — Config schema + parser (done)
Files: src/config/repo_config.ml, coqbot-config.toml, tests

  • Per-repo TOML schema, lookup helpers, find_by_github

M2 — Backport / project cards (done)
Files: src/actions/backport.ml, src/webhooks/github.ml (project events)

  • Backport and GitHub project card logic from config

M5 - CI job dispatch + doc status
PR: rocq-prover/bot#377
Files: src/actions/job.ml, src/ci/documentation.ml, src/ci/job_status.ml, src/webhooks/gitlab.ml
Depends on: M1

  • Route bench jobs and Rocq-specific failure handling from repo_config.jobs
  • Doc artifact / GitLab status URLs from GitLab coordinates; gate on doc_artifact_jobs
  • Thread repo_config_table through the GitLab job webhook

M6 - PR sync, team checks, and command gating
PR: rocq-prover/bot#378
Files: src/actions/pr_sync.ml, src/webhooks/github.ml (handle_comment_created), src/utils/bench.ml (org/team/domain args), bot-components/github/GitHub_automation.ml, src/config/repo_config.ml
Depends on: M1

  • Welcome message gated on contributing_url (absent -> skip)
  • Team mentions and merge/run-ci authorization from org_name + teams + alert_mention
  • run ci, merge now, bench accepted when repo has the relevant config/team (no rocq-prover/rocq guard)
  • run_ci_action / run_bench take org/team/gitlab_domain from config

M4 - Bench GitLab job URLs
PR: rocq-prover/bot#379
Files: src/utils/bench.ml, src/webhooks/github.ml, src/webhooks/gitlab.ml
Depends on: M1

  • Build status job URL from gitlab_domain / gitlab_owner / gitlab_repo
  • Build bench-summary job-link regex from the same coordinates + bench_job
  • Tests: URL/regex from config; missing GitLab coords handled cleanly

M7- Minimizer URL
PR: rocq-prover/bot#380
Files: src/webhooks/github.ml, src/ci/minimization.ml, src/webhooks/gitlab.ml
Depends on: M1

  • Use repo_config.minimizer_url; skip minimization offer when absent
  • Tests: with URL -> link present; without -> absent

M3 - Push / mirror routing
PR: rocq-prover/bot#381
Files: src/webhooks/github.ml (handle_push_event_for_repos, push branches)
Depends on: M1

  • Replace owner/repo string-match chains with repo_config lookups
  • Push on configured repo: backport if project configured; mirror if GitLab mapping exists
  • Tests: configured push mirrors; unconfigured push is a no-op

M8 - Integration test + example config
Depends on: M3–M7 (and merged M5/M6)

  • End-to-end test with two repos in TOML + synthetic webhooks
  • Add docs/example-config.toml
  • Remove any remaining dead hardcode paths
37% complete

Issues