This is an automated email from the ASF dual-hosted git repository.

potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git

commit ba8075502bc683dd6e05b9e28320ff5b04454c0b
Author: Jarek Potiuk <[email protected]>
AuthorDate: Sun Nov 15 05:00:51 2026 +0100

    Generate the fork CI diagrams from one source with the diagrams prek hook 
(#76841)
    
    * Generate the fork CI diagrams from one source with the diagrams prek hook
    
    The fork CI design document drew its architecture as ASCII art and its 
reconciler states and pull request lifecycle in Mermaid, while the ADIP-12 wiki 
page, which cannot render Mermaid, needs images. Keeping both copies would let 
them drift. Make Graphviz sources (diagram_fork_ci_*.py under 
dev/breeze/doc/ci/images/) the only copy: the generate-airflow-diagrams prek 
hook regenerates each SVG when its source changes, like the other diagrams in 
the repository, and the design document an [...]
    
    Generated-by: Claude Opus 5
    
    * Show the missing exits in the generated fork CI lifecycle diagram
    
    The Graphviz source gains the transitions added to the Mermaid version in
    review: the author's draft green state, the way back to running for an
    approved pull request, for one that needs project CI and for a disabled
    fork workflow, and when `use project ci` takes effect.
    
    Generated-by: Claude Opus 5
---
 .pre-commit-config.yaml                            |   3 +-
 .../doc/ci/08_fork_ci_for_external_contributors.md | 104 +-------
 .../ci/images/diagram_fork_ci_architecture.md5sum  |   1 +
 .../doc/ci/images/diagram_fork_ci_architecture.py  |  80 ++++++
 .../doc/ci/images/diagram_fork_ci_architecture.svg | 157 ++++++++++++
 .../doc/ci/images/diagram_fork_ci_lifecycle.md5sum |   1 +
 .../doc/ci/images/diagram_fork_ci_lifecycle.py     |  94 +++++++
 .../doc/ci/images/diagram_fork_ci_lifecycle.svg    | 283 ++++++++++++++++++++
 .../doc/ci/images/diagram_fork_ci_states.md5sum    |   1 +
 dev/breeze/doc/ci/images/diagram_fork_ci_states.py | 104 ++++++++
 .../doc/ci/images/diagram_fork_ci_states.svg       | 284 +++++++++++++++++++++
 11 files changed, 1014 insertions(+), 98 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 203d43f91b9..28963f1b65b 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1040,7 +1040,8 @@ repos:
           ^airflow-core/docs/.*/diagram_[^/]*\.py$|
           ^contributing-docs/images/diagram_[^/]*\.py$|
           ^docs/images/.*\.py$|
-          ^airflow-ctl/docs/images/diagrams/.*\.py$
+          ^airflow-ctl/docs/images/diagrams/.*\.py$|
+          ^dev/breeze/doc/ci/images/diagram_[^/]*\.py$
         pass_filenames: true
       - id: prevent-deprecated-sqlalchemy-usage
         name: Prevent deprecated sqlalchemy usage
diff --git a/dev/breeze/doc/ci/08_fork_ci_for_external_contributors.md 
b/dev/breeze/doc/ci/08_fork_ci_for_external_contributors.md
index fcd86b05ccb..af80afc3f65 100644
--- a/dev/breeze/doc/ci/08_fork_ci_for_external_contributors.md
+++ b/dev/breeze/doc/ci/08_fork_ci_for_external_contributors.md
@@ -78,26 +78,7 @@ Non-goals:
 
 ## Overview
 
-```
-             contributor fork                               apache/airflow
-   ┌──────────────────────────────────┐      
┌───────────────────────────────────────────┐
-   │ git push feature-branch          │      │ pull_request event              
          │
-   │   └─ ci-amd.yml (push trigger)   │      │   └─ ci-amd.yml                 
          │
-   │      ├─ gate job: fork -> run    │      │      └─ gate job: eligibility 
-> skip     │
-   │      ├─ build-info: fork mode    │      │         (build-info and 
everything after  │
-   │      │  changed files from       │      │          are skipped for gated 
PRs)       │
-   │      │  compare API vs upstream  │      │                                 
          │
-   │      └─ public runners only      │      │ fork-ci-monitor.yml (every 5 
minutes)     │
-   └──────────────────────────────────┘      │   └─ breeze ci 
fork-ci-reconcile          │
-                     ▲                       │      ├─ discover new gated PRs 
-> label   │
-                     │ GraphQL: checkSuites  │      ├─ per labelled PR: fork 
state ->    │
-                     │ REST: workflow state  │      │    draft/undraft, 
labels, comment, │
-                     └───────────────────────│      │    commit status with 
run link,    │
-                                             │      │    close after 30 days 
or when the │
-                                             │      │    PR tampered with the 
gate       │
-                                             │      └─ unknown failures -> 
Slack         │
-                                             
└───────────────────────────────────────────┘
-```
+![Fork CI architecture](images/diagram_fork_ci_architecture.svg)
 
 Four pieces, in dependency order:
 
@@ -109,6 +90,10 @@ Four pieces, in dependency order:
 
 Plus `breeze ci audit` for the contributor's local setup, and documentation.
 
+The diagrams in this document are SVG files in [`images/`](images/), generated 
from their
+`diagram_fork_ci_*.py` Graphviz sources by the `generate-airflow-diagrams` 
prek hook whenever a
+source changes. The ADIP-12 wiki page embeds the same files. Edit the source, 
not the SVG.
+
 ### Pull request lifecycle
 
 What a gated pull request shows, and who acts next, from the moment it is 
opened until it is merged
@@ -116,45 +101,7 @@ or closed. The [state machine](#state-machine) below is 
the reconciler's view of
 diagram is the contributor's and the maintainer's view. Pull requests of 
committers, collaborators
 and exempted organisations are not gated and follow the usual project CI flow.
 
-```mermaid
-%%{init: {'theme': 'neutral'}}%%
-stateDiagram-v2
-    state "Waiting for the author: draft, fork CI not set up or no run for the 
head commit" as waiting
-    state "Fork CI running" as running
-    state "Fork CI failed: out of the review queue" as failed
-    state "Green: ready for maintainer review, CI passed" as ready
-    state "Green, author's draft: stays a draft, no review label until the 
author marks it ready" as author_draft
-    state "Green, base too old: ready for maintainer review, CI passed pending 
until a rebase" as rebase
-    state "Green, CI files changed: needs project ci" as needs_project_ci
-    state "Project CI: use project ci, runs on the next push or a close and 
reopen" as project_ci
-    state "Approved" as approved
-    state "Merged" as merged
-    state "Closed after 30 days without fork CI activity" as closed
-
-    [*] --> waiting: an external contributor opens a pull request
-    waiting --> running: the author enables the fork workflow and pushes
-    running --> waiting: the fork workflow is disabled
-    running --> failed: a job fails, times out or is cancelled, or the run 
cannot start
-    running --> ready: the run passes on a current base
-    running --> author_draft: the run passes, and the author made the pull 
request a draft
-    running --> rebase: the run passes, but the base is 200+ commits behind or 
changed the same files
-    running --> needs_project_ci: the run passes, and the pull request changes 
CI-defining files
-    author_draft --> ready: the author marks it ready for review
-    failed --> running: the author pushes a fix
-    rebase --> running: the author rebases and pushes
-    ready --> running: the author pushes
-    needs_project_ci --> running: the author pushes
-    ready --> approved: a maintainer approves
-    rebase --> approved: a maintainer approves, the merge waits for the rebase
-    ready --> project_ci: a maintainer adds use project ci
-    needs_project_ci --> project_ci: a maintainer reviews the CI change and 
adds use project ci
-    project_ci --> approved: project CI passes and a maintainer approves
-    approved --> running: the author pushes or rebases
-    approved --> merged: merged, or auto-merged once CI passed is green
-    waiting --> closed: 30 days without fork CI activity
-    closed --> waiting: the author reopens it
-    merged --> [*]
-```
+![Pull request lifecycle](images/diagram_fork_ci_lifecycle.svg)
 
 - **Draft** is used only while the pull request waits for its author to set up 
fork CI or push. A
   failed run leaves the draft state unchanged and removes `ready for 
maintainer review`, so a flaky
@@ -601,44 +548,7 @@ pull requests without a fork run for their head commit, 
not by the total.
 
 ### State machine
 
-```mermaid
-%%{init: {'theme': 'neutral'}}%%
-stateDiagram-v2
-    [*] --> gated: discovery adds fork ci required
-    state gated {
-        [*] --> setup_required: workflow not enabled in the fork
-        [*] --> awaiting_push: workflow enabled, no run for the head commit
-        [*] --> running: fork run in progress
-        setup_required --> awaiting_push: author enables the workflow
-        awaiting_push --> running: author pushes
-        running --> failed: run fails, is cancelled, times out or cannot start
-        running --> green: run passes, no CI-defining change
-        running --> green_unverified: run passes, CI-defining change
-        failed --> running: author pushes
-        green --> running: author pushes
-        green_unverified --> running: author pushes
-        running --> setup_required: workflow disabled
-        awaiting_push --> setup_required: workflow disabled
-        state green {
-            [*] --> green_ready: not a draft, or the bot's draft
-            [*] --> green_author_draft: the author's draft
-            green_ready --> green_author_draft: author converts to draft
-            green_author_draft --> green_ready: author marks it ready
-        }
-        state green_unverified {
-            [*] --> unverified_ready: not a draft, or the bot's draft
-            [*] --> unverified_author_draft: the author's draft
-            unverified_ready --> unverified_author_draft: author converts to 
draft
-            unverified_author_draft --> unverified_ready: author marks it ready
-        }
-    }
-    gated --> closed: setup_required or awaiting_push for close_after_days (30 
days)
-    gated --> released: maintainer adds use project ci
-    gated --> ungated: base branch without fork CI, e.g. v3-3-test
-    gated --> gate_modified: pull request changes the gate
-    gated --> gate_bypassed: project CI ran without use project ci (gate 
tampering)
-    closed --> gated: reopened
-```
+![Fork CI reconciler states](images/diagram_fork_ci_states.svg)
 
 The draft state and the two review labels depend only on the state and on 
whether the pull
 request is the author's draft: a draft whose last convert-to-draft event was 
not by
diff --git a/dev/breeze/doc/ci/images/diagram_fork_ci_architecture.md5sum 
b/dev/breeze/doc/ci/images/diagram_fork_ci_architecture.md5sum
new file mode 100644
index 00000000000..49c405e73ef
--- /dev/null
+++ b/dev/breeze/doc/ci/images/diagram_fork_ci_architecture.md5sum
@@ -0,0 +1 @@
+0680ff8001f6f267b5b900af33ac16e3
diff --git a/dev/breeze/doc/ci/images/diagram_fork_ci_architecture.py 
b/dev/breeze/doc/ci/images/diagram_fork_ci_architecture.py
new file mode 100644
index 00000000000..6efe475797d
--- /dev/null
+++ b/dev/breeze/doc/ci/images/diagram_fork_ci_architecture.py
@@ -0,0 +1,80 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# /// script
+# requires-python = ">=3.11"
+# dependencies = [
+#    "rich>=13.6.0",
+#    "graphviz>=0.20.1",
+# ]
+# ///
+"""Where fork CI runs: the contributor fork and apache/airflow. Used in 
dev/breeze/doc/ci/08_fork_ci_for_external_contributors.md and on the ADIP-12 
wiki page."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import graphviz
+from rich.console import Console
+
+MY_DIR = Path(__file__).parent
+MY_FILENAME = Path(__file__).with_suffix("").name
+
+console = Console(width=400, color_system="standard")
+
+DOT = r"""
+digraph arch {
+  graph [rankdir=LR, fontname="Helvetica", fontsize=11, nodesep=0.4, 
ranksep=0.7, compound=true, bgcolor="white"];
+  node  [shape=box, style="rounded,filled", fillcolor="#f2f4f7", 
color="#5b6b80", fontname="Helvetica", fontsize=11];
+  edge  [fontname="Helvetica", fontsize=9, color="#5b6b80", 
fontcolor="#33404d"];
+
+  subgraph cluster_fork {
+    label="contributor's fork (GitHub-hosted runners, contributor's token)"; 
style="rounded"; color="#3d8b57"; fontname="Helvetica";
+    push   [label="git push feature-branch"];
+    ci     [label="Tests (AMD) workflow\npush trigger"];
+    gatef  [label="gate job:\nfork -> run"];
+    bi     [label="build-info in fork mode\nchanged files vs 
upstream\n(compare API)"];
+    tests  [label="tests and checks\non public runners"];
+    push -> ci -> gatef -> bi -> tests;
+  }
+
+  subgraph cluster_apache {
+    label="apache/airflow"; style="rounded"; color="#5b6b80"; 
fontname="Helvetica";
+    pr     [label="pull_request event"];
+    gatea  [label="gate job:\neligibility -> skip\n(build-info and all later 
jobs skipped)"];
+    mon    [label="fork-ci-monitor.yml\n(scheduled, never runs PR code)"];
+    rec    [label="breeze ci fork-ci-reconcile"];
+    out    [label="per gated PR: draft state, labels,\nstate comment, commit 
statuses\n(Fork CI / Tests (AMD), CI passed),\nclose after 30 days or on gate 
tampering"];
+    slack  [label="unknown failures -> Slack", fillcolor="#eceff3"];
+    pr -> gatea;
+    mon -> rec -> out;
+    rec -> slack [style=dashed];
+  }
+
+  tests -> rec [label="GraphQL: check suites\nREST: runs, jobs, workflow 
state\n(read by the monitor)", dir=back, style=dashed];
+}
+"""
+
+
+def generate_diagram() -> None:
+    image_file = MY_DIR / f"{MY_FILENAME}.svg"
+    console.print(f"[bright_blue]Generating {image_file}")
+    graphviz.Source(DOT).render(outfile=image_file, format="svg", cleanup=True)
+    console.print(f"[green]Generated {image_file}")
+
+
+if __name__ == "__main__":
+    generate_diagram()
diff --git a/dev/breeze/doc/ci/images/diagram_fork_ci_architecture.svg 
b/dev/breeze/doc/ci/images/diagram_fork_ci_architecture.svg
new file mode 100644
index 00000000000..2ce33697709
--- /dev/null
+++ b/dev/breeze/doc/ci/images/diagram_fork_ci_architecture.svg
@@ -0,0 +1,157 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
+ "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd";>
+<!-- Generated by graphviz version 16.1.0 (20260904.0139)
+ -->
+<!-- Title: arch Pages: 1 -->
+<svg width="1502pt" height="269pt"
+ viewBox="0.00 0.00 1502.00 269.00" xmlns="http://www.w3.org/2000/svg"; 
xmlns:xlink="http://www.w3.org/1999/xlink";>
+<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 265)">
+<title>arch</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-265 1497.75,-265 
1497.75,4 -4,4"/>
+<g id="clust1" class="cluster">
+<title>cluster_fork</title>
+<path fill="white" stroke="#3d8b57" d="M20,-173C20,-173 807.88,-173 
807.88,-173 813.88,-173 819.88,-179 819.88,-185 819.88,-185 819.88,-241 
819.88,-241 819.88,-247 813.88,-253 807.88,-253 807.88,-253 20,-253 20,-253 
14,-253 8,-247 8,-241 8,-241 8,-185 8,-185 8,-179 14,-173 20,-173"/>
+<text xml:space="preserve" text-anchor="middle" x="413.94" y="-238.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">contributor&#39;s fork 
(GitHub&#45;hosted runners, contributor&#39;s token)</text>
+</g>
+<g id="clust2" class="cluster">
+<title>cluster_apache</title>
+<path fill="white" stroke="#5b6b80" d="M679.5,-8C679.5,-8 1473.75,-8 
1473.75,-8 1479.75,-8 1485.75,-14 1485.75,-20 1485.75,-20 1485.75,-153 
1485.75,-153 1485.75,-159 1479.75,-165 1473.75,-165 1473.75,-165 679.5,-165 
679.5,-165 673.5,-165 667.5,-159 667.5,-153 667.5,-153 667.5,-20 667.5,-20 
667.5,-14 673.5,-8 679.5,-8"/>
+<text xml:space="preserve" text-anchor="middle" x="1076.62" y="-150.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">apache/airflow</text>
+</g>
+<!-- push -->
+<g id="node1" class="node">
+<title>push</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M131,-221C131,-221 28,-221 28,-221 
22,-221 16,-215 16,-209 16,-209 16,-197 16,-197 16,-191 22,-185 28,-185 28,-185 
131,-185 131,-185 137,-185 143,-191 143,-197 143,-197 143,-209 143,-209 
143,-215 137,-221 131,-221"/>
+<text xml:space="preserve" text-anchor="middle" x="79.5" y="-198.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">git push 
feature&#45;branch</text>
+</g>
+<!-- ci -->
+<g id="node2" class="node">
+<title>ci</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M303.75,-221C303.75,-221 206,-221 
206,-221 200,-221 194,-215 194,-209 194,-209 194,-197 194,-197 194,-191 
200,-185 206,-185 206,-185 303.75,-185 303.75,-185 309.75,-185 315.75,-191 
315.75,-197 315.75,-197 315.75,-209 315.75,-209 315.75,-215 309.75,-221 
303.75,-221"/>
+<text xml:space="preserve" text-anchor="middle" x="254.88" y="-204.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">Tests (AMD) workflow</text>
+<text xml:space="preserve" text-anchor="middle" x="254.88" y="-192.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">push trigger</text>
+</g>
+<!-- push&#45;&gt;ci -->
+<g id="edge1" class="edge">
+<title>push&#45;&gt;ci</title>
+<path fill="none" stroke="#5b6b80" d="M143.09,-203C155.85,-203 169.35,-203 
182.39,-203"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="182.18,-206.5 192.18,-203 
182.18,-199.5 182.18,-206.5"/>
+</g>
+<!-- gatef -->
+<g id="node3" class="node">
+<title>gatef</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M421,-221C421,-221 378.75,-221 
378.75,-221 372.75,-221 366.75,-215 366.75,-209 366.75,-209 366.75,-197 
366.75,-197 366.75,-191 372.75,-185 378.75,-185 378.75,-185 421,-185 421,-185 
427,-185 433,-191 433,-197 433,-197 433,-209 433,-209 433,-215 427,-221 
421,-221"/>
+<text xml:space="preserve" text-anchor="middle" x="399.88" y="-204.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">gate job:</text>
+<text xml:space="preserve" text-anchor="middle" x="399.88" y="-192.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">fork &#45;&gt; run</text>
+</g>
+<!-- ci&#45;&gt;gatef -->
+<g id="edge2" class="edge">
+<title>ci&#45;&gt;gatef</title>
+<path fill="none" stroke="#5b6b80" d="M316.11,-203C329.18,-203 342.77,-203 
355.06,-203"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="354.88,-206.5 364.88,-203 
354.88,-199.5 354.88,-206.5"/>
+</g>
+<!-- bi -->
+<g id="node4" class="node">
+<title>bi</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M612.5,-225C612.5,-225 496,-225 
496,-225 490,-225 484,-219 484,-213 484,-213 484,-193 484,-193 484,-187 
490,-181 496,-181 496,-181 612.5,-181 612.5,-181 618.5,-181 624.5,-187 
624.5,-193 624.5,-193 624.5,-213 624.5,-213 624.5,-219 618.5,-225 612.5,-225"/>
+<text xml:space="preserve" text-anchor="middle" x="554.25" y="-210.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">build&#45;info in fork 
mode</text>
+<text xml:space="preserve" text-anchor="middle" x="554.25" y="-198.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">changed files vs 
upstream</text>
+<text xml:space="preserve" text-anchor="middle" x="554.25" y="-186.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">(compare API)</text>
+</g>
+<!-- gatef&#45;&gt;bi -->
+<g id="edge3" class="edge">
+<title>gatef&#45;&gt;bi</title>
+<path fill="none" stroke="#5b6b80" d="M433.19,-203C444.84,-203 458.56,-203 
472.49,-203"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="472.16,-206.5 482.16,-203 
472.16,-199.5 472.16,-206.5"/>
+</g>
+<!-- tests -->
+<g id="node5" class="node">
+<title>tests</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M799.88,-219C799.88,-219 725.38,-219 
725.38,-219 719.38,-219 713.38,-213 713.38,-207 713.38,-207 713.38,-195 
713.38,-195 713.38,-189 719.38,-183 725.38,-183 725.38,-183 799.88,-183 
799.88,-183 805.88,-183 811.88,-189 811.88,-195 811.88,-195 811.88,-207 
811.88,-207 811.88,-213 805.88,-219 799.88,-219"/>
+<text xml:space="preserve" text-anchor="middle" x="762.62" y="-202.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">tests and checks</text>
+<text xml:space="preserve" text-anchor="middle" x="762.62" y="-190.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">on public runners</text>
+</g>
+<!-- bi&#45;&gt;tests -->
+<g id="edge4" class="edge">
+<title>bi&#45;&gt;tests</title>
+<path fill="none" stroke="#5b6b80" d="M624.83,-202.33C649.77,-202.08 
677.65,-201.81 701.7,-201.58"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="701.69,-205.08 711.66,-201.48 
701.62,-198.08 701.69,-205.08"/>
+</g>
+<!-- rec -->
+<g id="node9" class="node">
+<title>rec</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M1181.25,-137C1181.25,-137 1067,-137 
1067,-137 1061,-137 1055,-131 1055,-125 1055,-125 1055,-113 1055,-113 1055,-107 
1061,-101 1067,-101 1067,-101 1181.25,-101 1181.25,-101 1187.25,-101 
1193.25,-107 1193.25,-113 1193.25,-113 1193.25,-125 1193.25,-125 1193.25,-131 
1187.25,-137 1181.25,-137"/>
+<text xml:space="preserve" text-anchor="middle" x="1124.12" y="-114.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">breeze ci 
fork&#45;ci&#45;reconcile</text>
+</g>
+<!-- tests&#45;&gt;rec -->
+<g id="edge9" class="edge">
+<title>tests&#45;&gt;rec</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M823.16,-187.42C886.81,-172.9 987.61,-149.91 1054.55,-134.64"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="822.56,-183.97 813.58,-189.6 
824.11,-190.79 822.56,-183.97"/>
+<text xml:space="preserve" text-anchor="middle" x="940" y="-195.18" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">GraphQL: 
check suites</text>
+<text xml:space="preserve" text-anchor="middle" x="940" y="-185.43" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">REST: runs, 
jobs, workflow state</text>
+<text xml:space="preserve" text-anchor="middle" x="940" y="-175.68" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">(read by the 
monitor)</text>
+</g>
+<!-- pr -->
+<g id="node6" class="node">
+<title>pr</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M802.5,-62C802.5,-62 722.75,-62 
722.75,-62 716.75,-62 710.75,-56 710.75,-50 710.75,-50 710.75,-38 710.75,-38 
710.75,-32 716.75,-26 722.75,-26 722.75,-26 802.5,-26 802.5,-26 808.5,-26 
814.5,-32 814.5,-38 814.5,-38 814.5,-50 814.5,-50 814.5,-56 808.5,-62 
802.5,-62"/>
+<text xml:space="preserve" text-anchor="middle" x="762.62" y="-39.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">pull_request event</text>
+</g>
+<!-- gatea -->
+<g id="node7" class="node">
+<title>gatea</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M1206,-66C1206,-66 1042.25,-66 
1042.25,-66 1036.25,-66 1030.25,-60 1030.25,-54 1030.25,-54 1030.25,-34 
1030.25,-34 1030.25,-28 1036.25,-22 1042.25,-22 1042.25,-22 1206,-22 1206,-22 
1212,-22 1218,-28 1218,-34 1218,-34 1218,-54 1218,-54 1218,-60 1212,-66 
1206,-66"/>
+<text xml:space="preserve" text-anchor="middle" x="1124.12" y="-51.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">gate job:</text>
+<text xml:space="preserve" text-anchor="middle" x="1124.12" y="-39.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">eligibility &#45;&gt; 
skip</text>
+<text xml:space="preserve" text-anchor="middle" x="1124.12" y="-27.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">(build&#45;info and all 
later jobs skipped)</text>
+</g>
+<!-- pr&#45;&gt;gatea -->
+<g id="edge5" class="edge">
+<title>pr&#45;&gt;gatea</title>
+<path fill="none" stroke="#5b6b80" d="M814.75,-44C867.53,-44 951.37,-44 
1018.32,-44"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="1018.24,-47.5 1028.24,-44 
1018.24,-40.5 1018.24,-47.5"/>
+</g>
+<!-- mon -->
+<g id="node8" class="node">
+<title>mon</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M837.75,-137C837.75,-137 687.5,-137 
687.5,-137 681.5,-137 675.5,-131 675.5,-125 675.5,-125 675.5,-113 675.5,-113 
675.5,-107 681.5,-101 687.5,-101 687.5,-101 837.75,-101 837.75,-101 843.75,-101 
849.75,-107 849.75,-113 849.75,-113 849.75,-125 849.75,-125 849.75,-131 
843.75,-137 837.75,-137"/>
+<text xml:space="preserve" text-anchor="middle" x="762.62" y="-120.55" 
font-family="Helvetica,sans-Serif" 
font-size="11.00">fork&#45;ci&#45;monitor.yml</text>
+<text xml:space="preserve" text-anchor="middle" x="762.62" y="-108.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">(scheduled, never runs PR 
code)</text>
+</g>
+<!-- mon&#45;&gt;rec -->
+<g id="edge6" class="edge">
+<title>mon&#45;&gt;rec</title>
+<path fill="none" stroke="#5b6b80" d="M850.19,-119C909.02,-119 986.24,-119 
1043.53,-119"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="1043.2,-122.5 1053.2,-119 
1043.2,-115.5 1043.2,-122.5"/>
+</g>
+<!-- out -->
+<g id="node10" class="node">
+<title>out</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M1465.75,-72C1465.75,-72 1281,-72 
1281,-72 1275,-72 1269,-66 1269,-60 1269,-60 1269,-28 1269,-28 1269,-22 
1275,-16 1281,-16 1281,-16 1465.75,-16 1465.75,-16 1471.75,-16 1477.75,-22 
1477.75,-28 1477.75,-28 1477.75,-60 1477.75,-60 1477.75,-66 1471.75,-72 
1465.75,-72"/>
+<text xml:space="preserve" text-anchor="middle" x="1373.38" y="-57.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">per gated PR: draft state, 
labels,</text>
+<text xml:space="preserve" text-anchor="middle" x="1373.38" y="-45.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">state comment, commit 
statuses</text>
+<text xml:space="preserve" text-anchor="middle" x="1373.38" y="-33.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">(Fork CI / Tests (AMD), CI 
passed),</text>
+<text xml:space="preserve" text-anchor="middle" x="1373.38" y="-21.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">close after 30 days or on 
gate tampering</text>
+</g>
+<!-- rec&#45;&gt;out -->
+<g id="edge7" class="edge">
+<title>rec&#45;&gt;out</title>
+<path fill="none" stroke="#5b6b80" d="M1185.93,-100.56C1210.54,-93.09 
1239.68,-84.25 1267.52,-75.81"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="1268.52,-79.16 1277.08,-72.91 
1266.49,-72.46 1268.52,-79.16"/>
+</g>
+<!-- slack -->
+<g id="node11" class="node">
+<title>slack</title>
+<path fill="#eceff3" stroke="#5b6b80" d="M1431.25,-137C1431.25,-137 
1315.5,-137 1315.5,-137 1309.5,-137 1303.5,-131 1303.5,-125 1303.5,-125 
1303.5,-113 1303.5,-113 1303.5,-107 1309.5,-101 1315.5,-101 1315.5,-101 
1431.25,-101 1431.25,-101 1437.25,-101 1443.25,-107 1443.25,-113 1443.25,-113 
1443.25,-125 1443.25,-125 1443.25,-131 1437.25,-137 1431.25,-137"/>
+<text xml:space="preserve" text-anchor="middle" x="1373.38" y="-114.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">unknown failures &#45;&gt; 
Slack</text>
+</g>
+<!-- rec&#45;&gt;slack -->
+<g id="edge8" class="edge">
+<title>rec&#45;&gt;slack</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M1193.67,-119C1224.09,-119 1260.1,-119 1291.8,-119"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="1291.75,-122.5 1301.75,-119 
1291.75,-115.5 1291.75,-122.5"/>
+</g>
+</g>
+</svg>
diff --git a/dev/breeze/doc/ci/images/diagram_fork_ci_lifecycle.md5sum 
b/dev/breeze/doc/ci/images/diagram_fork_ci_lifecycle.md5sum
new file mode 100644
index 00000000000..d0118a17458
--- /dev/null
+++ b/dev/breeze/doc/ci/images/diagram_fork_ci_lifecycle.md5sum
@@ -0,0 +1 @@
+27566b64cbac2d256641b1dbf873fdc9
diff --git a/dev/breeze/doc/ci/images/diagram_fork_ci_lifecycle.py 
b/dev/breeze/doc/ci/images/diagram_fork_ci_lifecycle.py
new file mode 100644
index 00000000000..fcb7053e253
--- /dev/null
+++ b/dev/breeze/doc/ci/images/diagram_fork_ci_lifecycle.py
@@ -0,0 +1,94 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# /// script
+# requires-python = ">=3.11"
+# dependencies = [
+#    "rich>=13.6.0",
+#    "graphviz>=0.20.1",
+# ]
+# ///
+"""What a gated pull request shows, and who acts next, from opening to merge 
or close. Used in dev/breeze/doc/ci/08_fork_ci_for_external_contributors.md and 
on the ADIP-12 wiki page."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import graphviz
+from rich.console import Console
+
+MY_DIR = Path(__file__).parent
+MY_FILENAME = Path(__file__).with_suffix("").name
+
+console = Console(width=400, color_system="standard")
+
+DOT = r"""
+digraph lifecycle {
+  graph [rankdir=TB, fontname="Helvetica", fontsize=11, nodesep=0.5, 
ranksep=0.55, bgcolor="white"];
+  node  [shape=box, style="rounded,filled", fillcolor="#f2f4f7", 
color="#5b6b80", fontname="Helvetica", fontsize=11, margin="0.15,0.08"];
+  edge  [fontname="Helvetica", fontsize=9, color="#5b6b80", 
fontcolor="#33404d"];
+
+  start [shape=circle, label="", width=0.22, fillcolor="#33404d", 
color="#33404d"];
+  done  [shape=doublecircle, label="", width=0.18, fillcolor="#33404d", 
color="#33404d"];
+
+  waiting [label="Waiting for the author\n(draft: fork CI not set up,\nor no 
run for the head commit)"];
+  running [label="Fork CI running"];
+  failed  [label="Fork CI failed\n(out of the review queue)", 
fillcolor="#fde8e8", color="#b54848"];
+  ready   [label="Green\nready for maintainer review\nCI passed", 
fillcolor="#e6f4ea", color="#3d8b57"];
+  authordraft [label="Green, author's draft\nstays a draft, no review 
label\nuntil the author marks it ready", fillcolor="#e6f4ea", color="#3d8b57"];
+  rebase  [label="Green, base too old\nready for maintainer review\nCI passed 
pending until a rebase", fillcolor="#fff6db", color="#b38a1d"];
+  needs   [label="Green, CI files changed\nneeds project ci", 
fillcolor="#fff6db", color="#b38a1d"];
+  project [label="Project CI\n(use project ci)\nruns on the next push\nor a 
close and reopen"];
+  approved[label="Approved"];
+  merged  [label="Merged", fillcolor="#e6f4ea", color="#3d8b57"];
+  closed  [label="Closed after 30 days\nwithout fork CI activity", 
fillcolor="#eceff3", color="#8a96a3"];
+
+  start -> waiting [label="external contributor\nopens a pull request"];
+  waiting -> running [label="author enables the fork\nworkflow and pushes"];
+  running -> waiting [label="the fork workflow\nis disabled", style=dotted];
+  running -> failed [label="a job fails, times out,\nis cancelled, or the\nrun 
cannot start"];
+  running -> ready [label="passes on a\ncurrent base"];
+  running -> authordraft [label="passes, the author\nmade it a draft"];
+  authordraft -> ready [label="author marks it\nready for review"];
+  running -> rebase [label="passes, base 200+ commits\nbehind or changed\nthe 
same files"];
+  running -> needs [label="passes, changes\nCI-defining files"];
+  failed -> running [label="author pushes a fix"];
+  rebase -> running [label="author rebases\nand pushes"];
+  ready -> running [label="author pushes", style=dashed];
+  needs -> running [label="author pushes", style=dashed];
+  approved -> running [label="author pushes\nor rebases", style=dashed];
+  ready -> approved [label="maintainer approves"];
+  rebase -> approved [label="maintainer approves;\nmerge waits for the 
rebase", style=dashed];
+  ready -> project [label="maintainer adds\nuse project ci", style=dashed];
+  needs -> project [label="maintainer reviews the\nCI change, adds use project 
ci"];
+  project -> approved [label="project CI passes,\nmaintainer approves"];
+  approved -> merged [label="merged, or auto-merged\nonce CI passed is green"];
+  waiting -> closed [label="30 days without\nfork CI activity"];
+  closed -> waiting [label="author reopens", style=dashed];
+  merged -> done;
+}
+"""
+
+
+def generate_diagram() -> None:
+    image_file = MY_DIR / f"{MY_FILENAME}.svg"
+    console.print(f"[bright_blue]Generating {image_file}")
+    graphviz.Source(DOT).render(outfile=image_file, format="svg", cleanup=True)
+    console.print(f"[green]Generated {image_file}")
+
+
+if __name__ == "__main__":
+    generate_diagram()
diff --git a/dev/breeze/doc/ci/images/diagram_fork_ci_lifecycle.svg 
b/dev/breeze/doc/ci/images/diagram_fork_ci_lifecycle.svg
new file mode 100644
index 00000000000..7b5cc6e9393
--- /dev/null
+++ b/dev/breeze/doc/ci/images/diagram_fork_ci_lifecycle.svg
@@ -0,0 +1,283 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
+ "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd";>
+<!-- Generated by graphviz version 16.1.1 (20261108.1752)
+ -->
+<!-- Title: lifecycle Pages: 1 -->
+<svg width="1104pt" height="822pt"
+ viewBox="0.00 0.00 1104.00 822.00" xmlns="http://www.w3.org/2000/svg"; 
xmlns:xlink="http://www.w3.org/1999/xlink";>
+<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 
818.13)">
+<title>lifecycle</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-818.13 1100.3,-818.13 
1100.3,4 -4,4"/>
+<!-- start -->
+<g id="node1" class="node">
+<title>start</title>
+<ellipse fill="#33404d" stroke="#33404d" cx="655.8" cy="-806.21" rx="7.92" 
ry="7.92"/>
+</g>
+<!-- waiting -->
+<g id="node3" class="node">
+<title>waiting</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M727.35,-738.79C727.35,-738.79 
584.25,-738.79 584.25,-738.79 578.25,-738.79 572.25,-732.79 572.25,-726.79 
572.25,-726.79 572.25,-703.27 572.25,-703.27 572.25,-697.27 578.25,-691.27 
584.25,-691.27 584.25,-691.27 727.35,-691.27 727.35,-691.27 733.35,-691.27 
739.35,-697.27 739.35,-703.27 739.35,-703.27 739.35,-726.79 739.35,-726.79 
739.35,-732.79 733.35,-738.79 727.35,-738.79"/>
+<text xml:space="preserve" text-anchor="middle" x="655.8" y="-722.58" 
font-family="Helvetica,sans-Serif" font-size="11.00">Waiting for the 
author</text>
+<text xml:space="preserve" text-anchor="middle" x="655.8" y="-710.58" 
font-family="Helvetica,sans-Serif" font-size="11.00">(draft: fork CI not set 
up,</text>
+<text xml:space="preserve" text-anchor="middle" x="655.8" y="-698.58" 
font-family="Helvetica,sans-Serif" font-size="11.00">or no run for the head 
commit)</text>
+</g>
+<!-- start&#45;&gt;waiting -->
+<g id="edge1" class="edge">
+<title>start&#45;&gt;waiting</title>
+<path fill="none" stroke="#5b6b80" d="M655.8,-797.91C655.8,-787.52 
655.8,-767.77 655.8,-750.28"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="659.3,-750.46 655.8,-740.46 
652.3,-750.46 659.3,-750.46"/>
+<text xml:space="preserve" text-anchor="middle" x="697.42" y="-769.74" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">external 
contributor</text>
+<text xml:space="preserve" text-anchor="middle" x="697.42" y="-759.99" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">opens a pull 
request</text>
+</g>
+<!-- done -->
+<g id="node2" class="node">
+<title>done</title>
+<ellipse fill="#33404d" stroke="#33404d" cx="825.8" cy="-10.48" rx="6.48" 
ry="6.48"/>
+<ellipse fill="none" stroke="#33404d" cx="825.8" cy="-10.48" rx="10.48" 
ry="10.48"/>
+</g>
+<!-- running -->
+<g id="node4" class="node">
+<title>running</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M594.1,-631.77C594.1,-631.77 
521.5,-631.77 521.5,-631.77 515.5,-631.77 509.5,-625.77 509.5,-619.77 
509.5,-619.77 509.5,-607.77 509.5,-607.77 509.5,-601.77 515.5,-595.77 
521.5,-595.77 521.5,-595.77 594.1,-595.77 594.1,-595.77 600.1,-595.77 
606.1,-601.77 606.1,-607.77 606.1,-607.77 606.1,-619.77 606.1,-619.77 
606.1,-625.77 600.1,-631.77 594.1,-631.77"/>
+<text xml:space="preserve" text-anchor="middle" x="557.8" y="-609.32" 
font-family="Helvetica,sans-Serif" font-size="11.00">Fork CI running</text>
+</g>
+<!-- waiting&#45;&gt;running -->
+<g id="edge2" class="edge">
+<title>waiting&#45;&gt;running</title>
+<path fill="none" stroke="#5b6b80" d="M571.82,-705.78C526.48,-699.4 
476.99,-688.65 463.05,-671.27 447.86,-652.35 470.91,-638.32 498.07,-628.97"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="499.11,-632.31 507.58,-625.95 
496.99,-625.64 499.11,-632.31"/>
+<text xml:space="preserve" text-anchor="middle" x="509.92" y="-662.72" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
enables the fork</text>
+<text xml:space="preserve" text-anchor="middle" x="509.92" y="-652.97" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">workflow and 
pushes</text>
+</g>
+<!-- closed -->
+<g id="node13" class="node">
+<title>closed</title>
+<path fill="#eceff3" stroke="#8a96a3" d="M805.1,-631.77C805.1,-631.77 
702.5,-631.77 702.5,-631.77 696.5,-631.77 690.5,-625.77 690.5,-619.77 
690.5,-619.77 690.5,-607.77 690.5,-607.77 690.5,-601.77 696.5,-595.77 
702.5,-595.77 702.5,-595.77 805.1,-595.77 805.1,-595.77 811.1,-595.77 
817.1,-601.77 817.1,-607.77 817.1,-607.77 817.1,-619.77 817.1,-619.77 
817.1,-625.77 811.1,-631.77 805.1,-631.77"/>
+<text xml:space="preserve" text-anchor="middle" x="753.8" y="-615.32" 
font-family="Helvetica,sans-Serif" font-size="11.00">Closed after 30 days</text>
+<text xml:space="preserve" text-anchor="middle" x="753.8" y="-603.32" 
font-family="Helvetica,sans-Serif" font-size="11.00">without fork CI 
activity</text>
+</g>
+<!-- waiting&#45;&gt;closed -->
+<g id="edge21" class="edge">
+<title>waiting&#45;&gt;closed</title>
+<path fill="none" stroke="#5b6b80" d="M672.97,-690.84C682.45,-678.67 
694.76,-663.83 707.05,-651.77 711.48,-647.42 716.41,-643.08 721.35,-638.98"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="723.37,-641.84 728.97,-632.86 
718.98,-636.39 723.37,-641.84"/>
+<text xml:space="preserve" text-anchor="middle" x="738.92" y="-662.72" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">30 days 
without</text>
+<text xml:space="preserve" text-anchor="middle" x="738.92" y="-652.97" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">fork CI 
activity</text>
+</g>
+<!-- running&#45;&gt;waiting -->
+<g id="edge3" class="edge">
+<title>running&#45;&gt;waiting</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="1,5" 
d="M567.97,-632.18C575.32,-643.95 585.97,-659.45 597.55,-671.27 601.83,-675.64 
606.59,-679.89 611.5,-683.92"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="609.19,-686.55 619.22,-689.96 
613.5,-681.04 609.19,-686.55"/>
+<text xml:space="preserve" text-anchor="middle" x="631.67" y="-662.72" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">the fork 
workflow</text>
+<text xml:space="preserve" text-anchor="middle" x="631.67" y="-652.97" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">is 
disabled</text>
+</g>
+<!-- failed -->
+<g id="node5" class="node">
+<title>failed</title>
+<path fill="#fde8e8" stroke="#b54848" d="M129.6,-520.76C129.6,-520.76 
12,-520.76 12,-520.76 6,-520.76 0,-514.76 0,-508.76 0,-508.76 0,-496.76 
0,-496.76 0,-490.76 6,-484.76 12,-484.76 12,-484.76 129.6,-484.76 129.6,-484.76 
135.6,-484.76 141.6,-490.76 141.6,-496.76 141.6,-496.76 141.6,-508.76 
141.6,-508.76 141.6,-514.76 135.6,-520.76 129.6,-520.76"/>
+<text xml:space="preserve" text-anchor="middle" x="70.8" y="-504.31" 
font-family="Helvetica,sans-Serif" font-size="11.00">Fork CI failed</text>
+<text xml:space="preserve" text-anchor="middle" x="70.8" y="-492.31" 
font-family="Helvetica,sans-Serif" font-size="11.00">(out of the review 
queue)</text>
+</g>
+<!-- running&#45;&gt;failed -->
+<g id="edge4" class="edge">
+<title>running&#45;&gt;failed</title>
+<path fill="none" stroke="#5b6b80" d="M509.07,-612.76C391.14,-612.21 
97.85,-607.64 68.3,-575.77 57.59,-564.22 58.02,-546.61 61.22,-531.7"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="64.5,-532.99 63.68,-522.43 
57.74,-531.2 64.5,-532.99"/>
+<text xml:space="preserve" text-anchor="middle" x="109.55" y="-567.22" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">a job fails, 
times out,</text>
+<text xml:space="preserve" text-anchor="middle" x="109.55" y="-557.47" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">is 
cancelled, or the</text>
+<text xml:space="preserve" text-anchor="middle" x="109.55" y="-547.72" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">run cannot 
start</text>
+</g>
+<!-- ready -->
+<g id="node6" class="node">
+<title>ready</title>
+<path fill="#e6f4ea" stroke="#3d8b57" d="M593.85,-419.5C593.85,-419.5 
465.75,-419.5 465.75,-419.5 459.75,-419.5 453.75,-413.5 453.75,-407.5 
453.75,-407.5 453.75,-383.98 453.75,-383.98 453.75,-377.98 459.75,-371.98 
465.75,-371.98 465.75,-371.98 593.85,-371.98 593.85,-371.98 599.85,-371.98 
605.85,-377.98 605.85,-383.98 605.85,-383.98 605.85,-407.5 605.85,-407.5 
605.85,-413.5 599.85,-419.5 593.85,-419.5"/>
+<text xml:space="preserve" text-anchor="middle" x="529.8" y="-403.29" 
font-family="Helvetica,sans-Serif" font-size="11.00">Green</text>
+<text xml:space="preserve" text-anchor="middle" x="529.8" y="-391.29" 
font-family="Helvetica,sans-Serif" font-size="11.00">ready for maintainer 
review</text>
+<text xml:space="preserve" text-anchor="middle" x="529.8" y="-379.29" 
font-family="Helvetica,sans-Serif" font-size="11.00">CI passed</text>
+</g>
+<!-- running&#45;&gt;ready -->
+<g id="edge5" class="edge">
+<title>running&#45;&gt;ready</title>
+<path fill="none" stroke="#5b6b80" d="M555.56,-595.46C550.95,-559.9 
540.34,-478.08 534.28,-431.27"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="537.75,-430.87 533,-421.4 
530.81,-431.77 537.75,-430.87"/>
+<text xml:space="preserve" text-anchor="middle" x="572.08" y="-503.96" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">passes on 
a</text>
+<text xml:space="preserve" text-anchor="middle" x="572.08" y="-494.21" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">current 
base</text>
+</g>
+<!-- authordraft -->
+<g id="node7" class="node">
+<title>authordraft</title>
+<path fill="#e6f4ea" stroke="#3d8b57" d="M328.47,-526.52C328.47,-526.52 
189.12,-526.52 189.12,-526.52 183.12,-526.52 177.12,-520.52 177.12,-514.52 
177.12,-514.52 177.12,-491 177.12,-491 177.12,-485 183.12,-479 189.12,-479 
189.12,-479 328.47,-479 328.47,-479 334.47,-479 340.47,-485 340.47,-491 
340.47,-491 340.47,-514.52 340.47,-514.52 340.47,-520.52 334.47,-526.52 
328.47,-526.52"/>
+<text xml:space="preserve" text-anchor="middle" x="258.8" y="-510.31" 
font-family="Helvetica,sans-Serif" font-size="11.00">Green, author&#39;s 
draft</text>
+<text xml:space="preserve" text-anchor="middle" x="258.8" y="-498.31" 
font-family="Helvetica,sans-Serif" font-size="11.00">stays a draft, no review 
label</text>
+<text xml:space="preserve" text-anchor="middle" x="258.8" y="-486.31" 
font-family="Helvetica,sans-Serif" font-size="11.00">until the author marks it 
ready</text>
+</g>
+<!-- running&#45;&gt;authordraft -->
+<g id="edge6" class="edge">
+<title>running&#45;&gt;authordraft</title>
+<path fill="none" stroke="#5b6b80" d="M509.04,-610.01C446.52,-605.71 
342.29,-595.75 309.8,-575.77 294.78,-566.54 282.96,-551.05 274.5,-536.81"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="277.57,-535.13 269.66,-528.08 
271.45,-538.52 277.57,-535.13"/>
+<text xml:space="preserve" text-anchor="middle" x="347.3" y="-562.35" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">passes, the 
author</text>
+<text xml:space="preserve" text-anchor="middle" x="347.3" y="-552.6" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">made it a 
draft</text>
+</g>
+<!-- rebase -->
+<g id="node8" class="node">
+<title>rebase</title>
+<path fill="#fff6db" stroke="#b38a1d" d="M968.35,-526.52C968.35,-526.52 
813.25,-526.52 813.25,-526.52 807.25,-526.52 801.25,-520.52 801.25,-514.52 
801.25,-514.52 801.25,-491 801.25,-491 801.25,-485 807.25,-479 813.25,-479 
813.25,-479 968.35,-479 968.35,-479 974.35,-479 980.35,-485 980.35,-491 
980.35,-491 980.35,-514.52 980.35,-514.52 980.35,-520.52 974.35,-526.52 
968.35,-526.52"/>
+<text xml:space="preserve" text-anchor="middle" x="890.8" y="-510.31" 
font-family="Helvetica,sans-Serif" font-size="11.00">Green, base too old</text>
+<text xml:space="preserve" text-anchor="middle" x="890.8" y="-498.31" 
font-family="Helvetica,sans-Serif" font-size="11.00">ready for maintainer 
review</text>
+<text xml:space="preserve" text-anchor="middle" x="890.8" y="-486.31" 
font-family="Helvetica,sans-Serif" font-size="11.00">CI passed pending until a 
rebase</text>
+</g>
+<!-- running&#45;&gt;rebase -->
+<g id="edge8" class="edge">
+<title>running&#45;&gt;rebase</title>
+<path fill="none" stroke="#5b6b80" d="M606.5,-605.42C654.01,-597.86 
722.68,-585.82 747.8,-575.77 770.21,-566.81 772.27,-557.91 793.55,-546.52 
803.18,-541.36 813.57,-536.3 823.84,-531.57"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="824.99,-534.89 832.66,-527.58 
822.11,-528.51 824.99,-534.89"/>
+<text xml:space="preserve" text-anchor="middle" x="850.17" y="-567.22" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">passes, base 
200+ commits</text>
+<text xml:space="preserve" text-anchor="middle" x="850.17" y="-557.47" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">behind or 
changed</text>
+<text xml:space="preserve" text-anchor="middle" x="850.17" y="-547.72" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">the same 
files</text>
+</g>
+<!-- needs -->
+<g id="node9" class="node">
+<title>needs</title>
+<path fill="#fff6db" stroke="#b38a1d" d="M753.22,-520.76C753.22,-520.76 
642.38,-520.76 642.38,-520.76 636.38,-520.76 630.38,-514.76 630.38,-508.76 
630.38,-508.76 630.38,-496.76 630.38,-496.76 630.38,-490.76 636.38,-484.76 
642.38,-484.76 642.38,-484.76 753.22,-484.76 753.22,-484.76 759.22,-484.76 
765.22,-490.76 765.22,-496.76 765.22,-496.76 765.22,-508.76 765.22,-508.76 
765.22,-514.76 759.22,-520.76 753.22,-520.76"/>
+<text xml:space="preserve" text-anchor="middle" x="697.8" y="-504.31" 
font-family="Helvetica,sans-Serif" font-size="11.00">Green, CI files 
changed</text>
+<text xml:space="preserve" text-anchor="middle" x="697.8" y="-492.31" 
font-family="Helvetica,sans-Serif" font-size="11.00">needs project ci</text>
+</g>
+<!-- running&#45;&gt;needs -->
+<g id="edge9" class="edge">
+<title>running&#45;&gt;needs</title>
+<path fill="none" stroke="#5b6b80" d="M560.56,-595.38C563.76,-580.58 
570.42,-559.7 583.8,-546.52 593.84,-536.63 606.38,-528.99 619.45,-523.1"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="620.69,-526.37 628.6,-519.32 
618.02,-519.9 620.69,-526.37"/>
+<text xml:space="preserve" text-anchor="middle" x="618.3" y="-562.35" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">passes, 
changes</text>
+<text xml:space="preserve" text-anchor="middle" x="618.3" y="-552.6" 
font-family="Helvetica,sans-Serif" font-size="9.00" 
fill="#33404d">CI&#45;defining files</text>
+</g>
+<!-- failed&#45;&gt;running -->
+<g id="edge10" class="edge">
+<title>failed&#45;&gt;running</title>
+<path fill="none" stroke="#5b6b80" d="M108.83,-521.07C123.8,-528.35 
140.93,-537.27 155.8,-546.52 174.12,-557.91 174.46,-567.89 194.55,-575.77 
248.27,-596.86 409.32,-606.66 497.86,-610.57"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="497.68,-614.07 507.82,-611 
497.98,-607.07 497.68,-614.07"/>
+<text xml:space="preserve" text-anchor="middle" x="233.17" y="-557.47" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
pushes a fix</text>
+</g>
+<!-- ready&#45;&gt;running -->
+<g id="edge12" class="edge">
+<title>ready&#45;&gt;running</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M508.04,-419.58C486.22,-445.4 457.88,-488.75 473.3,-526.52 483.44,-551.37 
504.58,-572.94 523.18,-588.29"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="520.84,-590.91 530.85,-594.38 
525.19,-585.42 520.84,-590.91"/>
+<text xml:space="preserve" text-anchor="middle" x="502.55" y="-499.08" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
pushes</text>
+</g>
+<!-- project -->
+<g id="node10" class="node">
+<title>project</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M763.72,-312.48C763.72,-312.48 
661.88,-312.48 661.88,-312.48 655.88,-312.48 649.88,-306.48 649.88,-300.48 
649.88,-300.48 649.88,-264.96 649.88,-264.96 649.88,-258.96 655.88,-252.96 
661.88,-252.96 661.88,-252.96 763.72,-252.96 763.72,-252.96 769.72,-252.96 
775.72,-258.96 775.72,-264.96 775.72,-264.96 775.72,-300.48 775.72,-300.48 
775.72,-306.48 769.72,-312.48 763.72,-312.48"/>
+<text xml:space="preserve" text-anchor="middle" x="712.8" y="-296.27" 
font-family="Helvetica,sans-Serif" font-size="11.00">Project CI</text>
+<text xml:space="preserve" text-anchor="middle" x="712.8" y="-284.27" 
font-family="Helvetica,sans-Serif" font-size="11.00">(use project ci)</text>
+<text xml:space="preserve" text-anchor="middle" x="712.8" y="-272.27" 
font-family="Helvetica,sans-Serif" font-size="11.00">runs on the next 
push</text>
+<text xml:space="preserve" text-anchor="middle" x="712.8" y="-260.27" 
font-family="Helvetica,sans-Serif" font-size="11.00">or a close and 
reopen</text>
+</g>
+<!-- ready&#45;&gt;project -->
+<g id="edge17" class="edge">
+<title>ready&#45;&gt;project</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M555.35,-371.77C570.05,-359.23 589.24,-343.97 607.8,-332.48 617.71,-326.35 
628.51,-320.49 639.3,-315.1"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="640.79,-318.27 648.25,-310.75 
637.72,-311.98 640.79,-318.27"/>
+<text xml:space="preserve" text-anchor="middle" x="640.8" y="-343.43" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">maintainer 
adds</text>
+<text xml:space="preserve" text-anchor="middle" x="640.8" y="-333.68" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">use project 
ci</text>
+</g>
+<!-- approved -->
+<g id="node11" class="node">
+<title>approved</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M847.85,-193.46C847.85,-193.46 
803.75,-193.46 803.75,-193.46 797.75,-193.46 791.75,-187.46 791.75,-181.46 
791.75,-181.46 791.75,-169.46 791.75,-169.46 791.75,-163.46 797.75,-157.46 
803.75,-157.46 803.75,-157.46 847.85,-157.46 847.85,-157.46 853.85,-157.46 
859.85,-163.46 859.85,-169.46 859.85,-169.46 859.85,-181.46 859.85,-181.46 
859.85,-187.46 853.85,-193.46 847.85,-193.46"/>
+<text xml:space="preserve" text-anchor="middle" x="825.8" y="-171.01" 
font-family="Helvetica,sans-Serif" font-size="11.00">Approved</text>
+</g>
+<!-- ready&#45;&gt;approved -->
+<g id="edge15" class="edge">
+<title>ready&#45;&gt;approved</title>
+<path fill="none" stroke="#5b6b80" d="M525.59,-371.52C521.41,-340.6 
519.19,-285.96 547.8,-252.96 578.09,-218.03 709.4,-193.68 780.18,-182.83"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="780.55,-186.31 789.92,-181.36 
779.51,-179.39 780.55,-186.31"/>
+<text xml:space="preserve" text-anchor="middle" x="589.8" y="-279.05" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">maintainer 
approves</text>
+</g>
+<!-- authordraft&#45;&gt;ready -->
+<g id="edge7" class="edge">
+<title>authordraft&#45;&gt;ready</title>
+<path fill="none" stroke="#5b6b80" d="M275.43,-478.81C286.44,-465.3 
302.05,-449.04 319.55,-439.5 356.99,-419.09 402.98,-408.38 442.4,-402.78"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="442.64,-406.28 452.09,-401.5 
441.72,-399.34 442.64,-406.28"/>
+<text xml:space="preserve" text-anchor="middle" x="352.17" y="-450.45" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author marks 
it</text>
+<text xml:space="preserve" text-anchor="middle" x="352.17" y="-440.7" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">ready for 
review</text>
+</g>
+<!-- rebase&#45;&gt;running -->
+<g id="edge11" class="edge">
+<title>rebase&#45;&gt;running</title>
+<path fill="none" stroke="#5b6b80" d="M907.63,-526.79C916.81,-542.36 
924.05,-562.45 911.8,-575.77 893.76,-595.38 699.27,-592.71 672.8,-595.77 
654.87,-597.84 635.44,-600.54 617.74,-603.18"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="617.25,-599.71 607.89,-604.66 
618.3,-606.63 617.25,-599.71"/>
+<text xml:space="preserve" text-anchor="middle" x="949.03" y="-562.35" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
rebases</text>
+<text xml:space="preserve" text-anchor="middle" x="949.03" y="-552.6" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">and 
pushes</text>
+</g>
+<!-- rebase&#45;&gt;approved -->
+<g id="edge16" class="edge">
+<title>rebase&#45;&gt;approved</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M893.22,-478.78C897.54,-428.19 902.61,-304.46 860.8,-213.46 859.04,-209.62 
856.71,-205.92 854.09,-202.45"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="856.84,-200.27 847.66,-194.98 
851.53,-204.84 856.84,-200.27"/>
+<text xml:space="preserve" text-anchor="middle" x="947.51" y="-343.43" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">maintainer 
approves;</text>
+<text xml:space="preserve" text-anchor="middle" x="947.51" y="-333.68" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">merge waits 
for the rebase</text>
+</g>
+<!-- needs&#45;&gt;running -->
+<g id="edge13" class="edge">
+<title>needs&#45;&gt;running</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M692.13,-521.18C686.02,-537.38 674.84,-561.15 657.8,-575.77 646.1,-585.81 
631.43,-593.23 616.96,-598.68"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="616.23,-595.23 607.93,-601.81 
618.52,-601.84 616.23,-595.23"/>
+<text xml:space="preserve" text-anchor="middle" x="709.05" y="-557.47" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
pushes</text>
+</g>
+<!-- needs&#45;&gt;project -->
+<g id="edge18" class="edge">
+<title>needs&#45;&gt;project</title>
+<path fill="none" stroke="#5b6b80" d="M699,-484.29C701.38,-449.74 
706.73,-371.93 710.03,-324.02"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="713.5,-324.54 710.69,-314.33 
706.52,-324.06 713.5,-324.54"/>
+<text xml:space="preserve" text-anchor="middle" x="768.04" y="-396.94" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">maintainer 
reviews the</text>
+<text xml:space="preserve" text-anchor="middle" x="768.04" y="-387.19" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">CI change, 
adds use project ci</text>
+</g>
+<!-- project&#45;&gt;approved -->
+<g id="edge19" class="edge">
+<title>project&#45;&gt;approved</title>
+<path fill="none" stroke="#5b6b80" d="M735.11,-252.66C745.56,-239.94 
758.6,-225.26 771.8,-213.46 776.97,-208.84 782.75,-204.32 788.54,-200.11"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="790.15,-203.26 796.35,-194.66 
786.14,-197.52 790.15,-203.26"/>
+<text xml:space="preserve" text-anchor="middle" x="813.8" y="-224.41" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">project CI 
passes,</text>
+<text xml:space="preserve" text-anchor="middle" x="813.8" y="-214.66" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">maintainer 
approves</text>
+</g>
+<!-- approved&#45;&gt;running -->
+<g id="edge14" class="edge">
+<title>approved&#45;&gt;running</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M860.33,-178.23C920.41,-183.37 1037.8,-203.44 1037.8,-281.72 1037.8,-503.76 
1037.8,-503.76 1037.8,-503.76 1037.8,-542.47 1022.43,-556.59 988.8,-575.77 
958.24,-593.2 707.79,-592.08 672.8,-595.77 654.85,-597.66 635.41,-600.3 
617.71,-602.95"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="617.22,-599.48 607.86,-604.44 
618.28,-606.4 617.22,-599.48"/>
+<text xml:space="preserve" text-anchor="middle" x="1067.05" y="-396.94" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
pushes</text>
+<text xml:space="preserve" text-anchor="middle" x="1067.05" y="-387.19" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">or 
rebases</text>
+</g>
+<!-- merged -->
+<g id="node12" class="node">
+<title>merged</title>
+<path fill="#e6f4ea" stroke="#3d8b57" d="M842.97,-97.96C842.97,-97.96 
808.62,-97.96 808.62,-97.96 802.62,-97.96 796.62,-91.96 796.62,-85.96 
796.62,-85.96 796.62,-73.96 796.62,-73.96 796.62,-67.96 802.62,-61.96 
808.62,-61.96 808.62,-61.96 842.97,-61.96 842.97,-61.96 848.97,-61.96 
854.97,-67.96 854.97,-73.96 854.97,-73.96 854.97,-85.96 854.97,-85.96 
854.97,-91.96 848.97,-97.96 842.97,-97.96"/>
+<text xml:space="preserve" text-anchor="middle" x="825.8" y="-75.51" 
font-family="Helvetica,sans-Serif" font-size="11.00">Merged</text>
+</g>
+<!-- approved&#45;&gt;merged -->
+<g id="edge20" class="edge">
+<title>approved&#45;&gt;merged</title>
+<path fill="none" stroke="#5b6b80" d="M825.8,-157.31C825.8,-143.95 
825.8,-125.11 825.8,-109.49"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="829.3,-109.83 825.8,-99.83 
822.3,-109.83 829.3,-109.83"/>
+<text xml:space="preserve" text-anchor="middle" x="875.3" y="-128.91" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">merged, or 
auto&#45;merged</text>
+<text xml:space="preserve" text-anchor="middle" x="875.3" y="-119.16" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">once CI 
passed is green</text>
+</g>
+<!-- merged&#45;&gt;done -->
+<g id="edge23" class="edge">
+<title>merged&#45;&gt;done</title>
+<path fill="none" stroke="#5b6b80" d="M825.8,-61.58C825.8,-52.78 825.8,-42.01 
825.8,-32.71"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="829.3,-32.79 825.8,-22.79 
822.3,-32.79 829.3,-32.79"/>
+</g>
+<!-- closed&#45;&gt;waiting -->
+<g id="edge22" class="edge">
+<title>closed&#45;&gt;waiting</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M768.85,-632.15C777.13,-643.91 784.17,-659.4 775.8,-671.27 769.04,-680.86 
759.93,-688.31 749.73,-694.09"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="748.38,-690.86 741.01,-698.47 
751.52,-697.11 748.38,-690.86"/>
+<text xml:space="preserve" text-anchor="middle" x="810.68" y="-657.85" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
reopens</text>
+</g>
+</g>
+</svg>
diff --git a/dev/breeze/doc/ci/images/diagram_fork_ci_states.md5sum 
b/dev/breeze/doc/ci/images/diagram_fork_ci_states.md5sum
new file mode 100644
index 00000000000..7cd7ef394cf
--- /dev/null
+++ b/dev/breeze/doc/ci/images/diagram_fork_ci_states.md5sum
@@ -0,0 +1 @@
+e83d975c093d3a3c23d598f4be0077c3
diff --git a/dev/breeze/doc/ci/images/diagram_fork_ci_states.py 
b/dev/breeze/doc/ci/images/diagram_fork_ci_states.py
new file mode 100644
index 00000000000..47b3a9c6611
--- /dev/null
+++ b/dev/breeze/doc/ci/images/diagram_fork_ci_states.py
@@ -0,0 +1,104 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# /// script
+# requires-python = ">=3.11"
+# dependencies = [
+#    "rich>=13.6.0",
+#    "graphviz>=0.20.1",
+# ]
+# ///
+"""The fork CI reconciler's states for a gated pull request. Used in 
dev/breeze/doc/ci/08_fork_ci_for_external_contributors.md and on the ADIP-12 
wiki page."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import graphviz
+from rich.console import Console
+
+MY_DIR = Path(__file__).parent
+MY_FILENAME = Path(__file__).with_suffix("").name
+
+console = Console(width=400, color_system="standard")
+
+DOT = r"""
+digraph states {
+  graph [rankdir=TB, fontname="Helvetica", fontsize=11, nodesep=0.45, 
ranksep=0.5, compound=true, bgcolor="white"];
+  node  [shape=box, style="rounded,filled", fillcolor="#f2f4f7", 
color="#5b6b80", fontname="Helvetica", fontsize=11];
+  edge  [fontname="Helvetica", fontsize=9, color="#5b6b80", 
fontcolor="#33404d"];
+
+  start [shape=circle, label="", width=0.22, fillcolor="#33404d", 
color="#33404d"];
+
+  subgraph cluster_gated {
+    label="gated (label: fork ci required)"; fontname="Helvetica"; 
fontsize=12; style="rounded"; color="#8a96a3";
+    setup_required [label="setup_required\nworkflow not enabled in the 
fork\n(draft)"];
+    awaiting_push  [label="awaiting_push\nworkflow enabled, no run\nfor the 
head commit (draft)"];
+    running        [label="running\nfork run in progress"];
+    failed         [label="failed\nrun failed, cancelled, timed out\nor could 
not start", fillcolor="#fde8e8", color="#b54848"];
+    subgraph cluster_green {
+      label="green: no CI-defining change"; fontname="Helvetica"; fontsize=10; 
style="rounded,dashed"; color="#3d8b57";
+      green              [label="ready for maintainer review\n(not a draft, or 
the bot's draft)", fillcolor="#e6f4ea", color="#3d8b57"];
+      green_author_draft [label="the author's draft\nauthor marks it ready", 
fillcolor="#e6f4ea", color="#3d8b57"];
+    }
+    subgraph cluster_green_unverified {
+      label="green_unverified: CI-defining change"; fontname="Helvetica"; 
fontsize=10; style="rounded,dashed"; color="#b38a1d";
+      green_unverified        [label="needs project ci\n(not a draft, or the 
bot's draft)", fillcolor="#fff6db", color="#b38a1d"];
+      unverified_author_draft [label="the author's draft\nauthor marks it 
ready", fillcolor="#fff6db", color="#b38a1d"];
+    }
+  }
+
+  closed        [label="closed\nsetup_required or awaiting_push\nfor 30 days", 
fillcolor="#eceff3", color="#8a96a3"];
+  released      [label="released\nmaintainer added use project ci"];
+  ungated       [label="ungated\nbase branch without fork CI"];
+  gate_modified [label="gate_modified\nPR changes the gate (closed)", 
fillcolor="#fde8e8", color="#b54848"];
+  gate_bypassed [label="gate_bypassed\nproject CI ran without\nuse project ci 
(closed)", fillcolor="#fde8e8", color="#b54848"];
+
+  start -> setup_required [label="discovery adds\nfork ci required", 
lhead=cluster_gated];
+  setup_required -> awaiting_push [label="author enables\nthe workflow"];
+  awaiting_push -> running [label="author pushes"];
+  running -> failed [label="run fails"];
+  running -> green [label="run passes", lhead=cluster_green];
+  running -> green_unverified [label="run passes,\nCI files changed", 
lhead=cluster_green_unverified];
+  green -> green_author_draft [label="author converts\nto draft"];
+  green_author_draft -> green [label="author marks\nit ready", style=dashed];
+  green_unverified -> unverified_author_draft [label="author converts\nto 
draft"];
+  unverified_author_draft -> green_unverified [label="author marks\nit ready", 
style=dashed];
+  failed -> running [label="author pushes", style=dashed];
+  green -> running [label="author pushes", style=dashed, ltail=cluster_green];
+  green_unverified -> running [label="author pushes", style=dashed, 
ltail=cluster_green_unverified];
+  running -> setup_required [label="workflow disabled", style=dotted];
+  awaiting_push -> setup_required [label="workflow disabled", style=dotted];
+
+  awaiting_push -> closed [label="30 days", ltail=cluster_gated];
+  closed -> awaiting_push [label="reopened", style=dashed, 
lhead=cluster_gated];
+  green_unverified -> released [label="maintainer adds\nuse project ci", 
ltail=cluster_gated];
+  green -> ungated [label="base without fork CI", ltail=cluster_gated];
+  failed -> gate_modified [label="PR changes the gate", ltail=cluster_gated];
+  running -> gate_bypassed [label="gate tampering", ltail=cluster_gated];
+}
+"""
+
+
+def generate_diagram() -> None:
+    image_file = MY_DIR / f"{MY_FILENAME}.svg"
+    console.print(f"[bright_blue]Generating {image_file}")
+    graphviz.Source(DOT).render(outfile=image_file, format="svg", cleanup=True)
+    console.print(f"[green]Generated {image_file}")
+
+
+if __name__ == "__main__":
+    generate_diagram()
diff --git a/dev/breeze/doc/ci/images/diagram_fork_ci_states.svg 
b/dev/breeze/doc/ci/images/diagram_fork_ci_states.svg
new file mode 100644
index 00000000000..2489a3881ce
--- /dev/null
+++ b/dev/breeze/doc/ci/images/diagram_fork_ci_states.svg
@@ -0,0 +1,284 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
+ "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd";>
+<!-- Generated by graphviz version 16.1.1 (20261108.1752)
+ -->
+<!-- Title: states Pages: 1 -->
+<svg width="1464pt" height="526pt"
+ viewBox="0.00 0.00 1464.00 526.00" xmlns="http://www.w3.org/2000/svg"; 
xmlns:xlink="http://www.w3.org/1999/xlink";>
+<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 
521.84)">
+<title>states</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-521.84 1460.38,-521.84 
1460.38,4 -4,4"/>
+<g id="clust1" class="cluster">
+<title>cluster_gated</title>
+<path fill="white" stroke="#8a96a3" d="M20,-73.75C20,-73.75 886,-73.75 
886,-73.75 892,-73.75 898,-79.75 898,-85.75 898,-85.75 898,-444.5 898,-444.5 
898,-450.5 892,-456.5 886,-456.5 886,-456.5 20,-456.5 20,-456.5 14,-456.5 
8,-450.5 8,-444.5 8,-444.5 8,-85.75 8,-85.75 8,-79.75 14,-73.75 20,-73.75"/>
+<text xml:space="preserve" text-anchor="middle" x="453" y="-441.1" 
font-family="Helvetica,sans-Serif" font-size="12.00">gated (label: fork ci 
required)</text>
+</g>
+<g id="clust2" class="cluster">
+<title>cluster_green</title>
+<path fill="white" stroke="#3d8b57" stroke-dasharray="5,2" 
d="M28,-167.5C28,-167.5 205,-167.5 205,-167.5 211,-167.5 217,-173.5 217,-179.5 
217,-179.5 217,-326.25 217,-326.25 217,-332.25 211,-338.25 205,-338.25 
205,-338.25 28,-338.25 28,-338.25 22,-338.25 16,-332.25 16,-326.25 16,-326.25 
16,-179.5 16,-179.5 16,-173.5 22,-167.5 28,-167.5"/>
+<text xml:space="preserve" text-anchor="middle" x="116.5" y="-324.75" 
font-family="Helvetica,sans-Serif" font-size="10.00">green: no CI&#45;defining 
change</text>
+</g>
+<g id="clust3" class="cluster">
+<title>cluster_green_unverified</title>
+<path fill="white" stroke="#b38a1d" stroke-dasharray="5,2" 
d="M407,-167.5C407,-167.5 584,-167.5 584,-167.5 590,-167.5 596,-173.5 
596,-179.5 596,-179.5 596,-326.25 596,-326.25 596,-332.25 590,-338.25 
584,-338.25 584,-338.25 407,-338.25 407,-338.25 401,-338.25 395,-332.25 
395,-326.25 395,-326.25 395,-179.5 395,-179.5 395,-173.5 401,-167.5 
407,-167.5"/>
+<text xml:space="preserve" text-anchor="middle" x="495.5" y="-324.75" 
font-family="Helvetica,sans-Serif" font-size="10.00">green_unverified: 
CI&#45;defining change</text>
+</g>
+<!-- start -->
+<g id="node1" class="node">
+<title>start</title>
+<ellipse fill="#33404d" stroke="#33404d" cx="717" cy="-509.92" rx="7.92" 
ry="7.92"/>
+</g>
+<!-- setup_required -->
+<g id="node2" class="node">
+<title>setup_required</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M789.12,-427.75C789.12,-427.75 
644.88,-427.75 644.88,-427.75 638.88,-427.75 632.88,-421.75 632.88,-415.75 
632.88,-415.75 632.88,-395.75 632.88,-395.75 632.88,-389.75 638.88,-383.75 
644.88,-383.75 644.88,-383.75 789.12,-383.75 789.12,-383.75 795.12,-383.75 
801.12,-389.75 801.12,-395.75 801.12,-395.75 801.12,-415.75 801.12,-415.75 
801.12,-421.75 795.12,-427.75 789.12,-427.75"/>
+<text xml:space="preserve" text-anchor="middle" x="717" y="-413.3" 
font-family="Helvetica,sans-Serif" font-size="11.00">setup_required</text>
+<text xml:space="preserve" text-anchor="middle" x="717" y="-401.3" 
font-family="Helvetica,sans-Serif" font-size="11.00">workflow not enabled in 
the fork</text>
+<text xml:space="preserve" text-anchor="middle" x="717" y="-389.3" 
font-family="Helvetica,sans-Serif" font-size="11.00">(draft)</text>
+</g>
+<!-- start&#45;&gt;setup_required -->
+<g id="edge1" class="edge">
+<title>start&#45;&gt;setup_required</title>
+<path fill="none" stroke="#5b6b80" d="M717,-501.57C717,-494.03 717,-481.5 
717,-467.99"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="720.5,-468.01 717,-458.01 
713.5,-468.01 720.5,-468.01"/>
+<text xml:space="preserve" text-anchor="middle" x="747.75" y="-475.45" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">discovery 
adds</text>
+<text xml:space="preserve" text-anchor="middle" x="747.75" y="-465.7" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">fork ci 
required</text>
+</g>
+<!-- awaiting_push -->
+<g id="node3" class="node">
+<title>awaiting_push</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M877.75,-315C877.75,-315 758.25,-315 
758.25,-315 752.25,-315 746.25,-309 746.25,-303 746.25,-303 746.25,-283 
746.25,-283 746.25,-277 752.25,-271 758.25,-271 758.25,-271 877.75,-271 
877.75,-271 883.75,-271 889.75,-277 889.75,-283 889.75,-283 889.75,-303 
889.75,-303 889.75,-309 883.75,-315 877.75,-315"/>
+<text xml:space="preserve" text-anchor="middle" x="818" y="-300.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">awaiting_push</text>
+<text xml:space="preserve" text-anchor="middle" x="818" y="-288.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">workflow enabled, no 
run</text>
+<text xml:space="preserve" text-anchor="middle" x="818" y="-276.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">for the head commit 
(draft)</text>
+</g>
+<!-- setup_required&#45;&gt;awaiting_push -->
+<g id="edge2" class="edge">
+<title>setup_required&#45;&gt;awaiting_push</title>
+<path fill="none" stroke="#5b6b80" d="M710.53,-383.25C708.29,-371.5 
707.79,-357.16 714.5,-346.25 717.47,-341.42 737.9,-330.71 759.83,-320.24"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="761.03,-323.54 768.59,-316.11 
758.05,-317.21 761.03,-323.54"/>
+<text xml:space="preserve" text-anchor="middle" x="745.25" y="-357.2" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
enables</text>
+<text xml:space="preserve" text-anchor="middle" x="745.25" y="-347.45" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">the 
workflow</text>
+</g>
+<!-- awaiting_push&#45;&gt;setup_required -->
+<g id="edge15" class="edge">
+<title>awaiting_push&#45;&gt;setup_required</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="1,5" 
d="M810.24,-315.31C803.87,-330.65 793.67,-351.13 780,-365.75 776.35,-369.66 
772.22,-373.32 767.87,-376.72"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="766,-373.75 759.93,-382.44 
770.09,-379.43 766,-373.75"/>
+<text xml:space="preserve" text-anchor="middle" x="831.35" y="-352.32" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">workflow 
disabled</text>
+</g>
+<!-- running -->
+<g id="node4" class="node">
+<title>running</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M763.5,-211.5C763.5,-211.5 
678.5,-211.5 678.5,-211.5 672.5,-211.5 666.5,-205.5 666.5,-199.5 666.5,-199.5 
666.5,-187.5 666.5,-187.5 666.5,-181.5 672.5,-175.5 678.5,-175.5 678.5,-175.5 
763.5,-175.5 763.5,-175.5 769.5,-175.5 775.5,-181.5 775.5,-187.5 775.5,-187.5 
775.5,-199.5 775.5,-199.5 775.5,-205.5 769.5,-211.5 763.5,-211.5"/>
+<text xml:space="preserve" text-anchor="middle" x="721" y="-195.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">running</text>
+<text xml:space="preserve" text-anchor="middle" x="721" y="-183.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">fork run in progress</text>
+</g>
+<!-- awaiting_push&#45;&gt;running -->
+<g id="edge3" class="edge">
+<title>awaiting_push&#45;&gt;running</title>
+<path fill="none" stroke="#5b6b80" d="M813.49,-270.56C810.07,-258.53 
804.32,-243.91 795,-233.5 789.61,-227.47 783.06,-222.23 776.11,-217.7"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="778.15,-214.84 767.77,-212.74 
774.58,-220.86 778.15,-214.84"/>
+<text xml:space="preserve" text-anchor="middle" x="836.07" y="-239.57" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
pushes</text>
+</g>
+<!-- closed -->
+<g id="node10" class="node">
+<title>closed</title>
+<path fill="#eceff3" stroke="#8a96a3" d="M1444.38,-215.5C1444.38,-215.5 
1295.62,-215.5 1295.62,-215.5 1289.62,-215.5 1283.62,-209.5 1283.62,-203.5 
1283.62,-203.5 1283.62,-183.5 1283.62,-183.5 1283.62,-177.5 1289.62,-171.5 
1295.62,-171.5 1295.62,-171.5 1444.38,-171.5 1444.38,-171.5 1450.38,-171.5 
1456.38,-177.5 1456.38,-183.5 1456.38,-183.5 1456.38,-203.5 1456.38,-203.5 
1456.38,-209.5 1450.38,-215.5 1444.38,-215.5"/>
+<text xml:space="preserve" text-anchor="middle" x="1370" y="-201.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">closed</text>
+<text xml:space="preserve" text-anchor="middle" x="1370" y="-189.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">setup_required or 
awaiting_push</text>
+<text xml:space="preserve" text-anchor="middle" x="1370" y="-177.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">for 30 days</text>
+</g>
+<!-- awaiting_push&#45;&gt;closed -->
+<g id="edge16" class="edge">
+<title>awaiting_push&#45;&gt;closed</title>
+<path fill="none" stroke="#5b6b80" d="M898,-292.68C984.5,-291.58 
1125.74,-284.39 1243,-253 1250.77,-250.92 1284.53,-235.32 1315.28,-220.75"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="1316.66,-223.97 
1324.19,-216.52 1313.66,-217.65 1316.66,-223.97"/>
+<text xml:space="preserve" text-anchor="middle" x="1303.29" y="-239.57" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">30 
days</text>
+</g>
+<!-- running&#45;&gt;setup_required -->
+<g id="edge14" class="edge">
+<title>running&#45;&gt;setup_required</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="1,5" 
d="M755.41,-211.97C773.38,-223.37 789.3,-238.73 777,-253 741.65,-294.02 
691.85,-229.98 656.5,-271 636.99,-293.64 645.72,-310.37 656.5,-338.25 
661.88,-352.15 671.66,-364.93 681.81,-375.49"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="679.28,-377.92 688.87,-382.41 
684.18,-372.91 679.28,-377.92"/>
+<text xml:space="preserve" text-anchor="middle" x="693.25" y="-289.32" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">workflow 
disabled</text>
+</g>
+<!-- failed -->
+<g id="node5" class="node">
+<title>failed</title>
+<path fill="#fde8e8" stroke="#b54848" d="M789.75,-125.75C789.75,-125.75 
652.25,-125.75 652.25,-125.75 646.25,-125.75 640.25,-119.75 640.25,-113.75 
640.25,-113.75 640.25,-93.75 640.25,-93.75 640.25,-87.75 646.25,-81.75 
652.25,-81.75 652.25,-81.75 789.75,-81.75 789.75,-81.75 795.75,-81.75 
801.75,-87.75 801.75,-93.75 801.75,-93.75 801.75,-113.75 801.75,-113.75 
801.75,-119.75 795.75,-125.75 789.75,-125.75"/>
+<text xml:space="preserve" text-anchor="middle" x="721" y="-111.3" 
font-family="Helvetica,sans-Serif" font-size="11.00">failed</text>
+<text xml:space="preserve" text-anchor="middle" x="721" y="-99.3" 
font-family="Helvetica,sans-Serif" font-size="11.00">run failed, cancelled, 
timed out</text>
+<text xml:space="preserve" text-anchor="middle" x="721" y="-87.3" 
font-family="Helvetica,sans-Serif" font-size="11.00">or could not start</text>
+</g>
+<!-- running&#45;&gt;failed -->
+<g id="edge4" class="edge">
+<title>running&#45;&gt;failed</title>
+<path fill="none" stroke="#5b6b80" d="M727.51,-175.29C729.72,-168.59 
731.9,-160.79 733,-153.5 733.82,-148.08 733.51,-142.37 732.57,-136.85"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="736.04,-136.31 730.3,-127.41 
729.24,-137.95 736.04,-136.31"/>
+<text xml:space="preserve" text-anchor="middle" x="749.6" y="-144.95" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">run 
fails</text>
+</g>
+<!-- green -->
+<g id="node6" class="node">
+<title>green</title>
+<path fill="#e6f4ea" stroke="#3d8b57" d="M197.12,-311C197.12,-311 64.88,-311 
64.88,-311 58.88,-311 52.88,-305 52.88,-299 52.88,-299 52.88,-287 52.88,-287 
52.88,-281 58.88,-275 64.88,-275 64.88,-275 197.12,-275 197.12,-275 203.12,-275 
209.12,-281 209.12,-287 209.12,-287 209.12,-299 209.12,-299 209.12,-305 
203.12,-311 197.12,-311"/>
+<text xml:space="preserve" text-anchor="middle" x="131" y="-294.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">ready for maintainer 
review</text>
+<text xml:space="preserve" text-anchor="middle" x="131" y="-282.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">(not a draft, or the 
bot&#39;s draft)</text>
+</g>
+<!-- running&#45;&gt;green -->
+<g id="edge5" class="edge">
+<title>running&#45;&gt;green</title>
+<path fill="none" stroke="#5b6b80" d="M666.13,-205.62C646.59,-209.24 
624.38,-212.98 604,-215.5 488.16,-229.83 454.09,-200.96 342,-233.5 
324.52,-238.57 323.04,-246.63 306,-253 278.85,-263.15 248.29,-271.08 
220.39,-277.06"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="228.19,-272.91 218.51,-277.21 
228.76,-279.89 228.19,-272.91"/>
+<text xml:space="preserve" text-anchor="middle" x="364.5" y="-239.57" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">run 
passes</text>
+</g>
+<!-- green_unverified -->
+<g id="node8" class="node">
+<title>green_unverified</title>
+<path fill="#fff6db" stroke="#b38a1d" d="M565.12,-311C565.12,-311 432.88,-311 
432.88,-311 426.88,-311 420.88,-305 420.88,-299 420.88,-299 420.88,-287 
420.88,-287 420.88,-281 426.88,-275 432.88,-275 432.88,-275 565.12,-275 
565.12,-275 571.12,-275 577.12,-281 577.12,-287 577.12,-287 577.12,-299 
577.12,-299 577.12,-305 571.12,-311 565.12,-311"/>
+<text xml:space="preserve" text-anchor="middle" x="499" y="-294.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">needs project ci</text>
+<text xml:space="preserve" text-anchor="middle" x="499" y="-282.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">(not a draft, or the 
bot&#39;s draft)</text>
+</g>
+<!-- running&#45;&gt;green_unverified -->
+<g id="edge6" class="edge">
+<title>running&#45;&gt;green_unverified</title>
+<path fill="none" stroke="#5b6b80" d="M714.87,-211.94C709.23,-225.34 
699.51,-243.17 685,-253 654.43,-273.7 635.97,-266.88 607.13,-267.83"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="607.24,-264.31 597.51,-268.49 
607.72,-271.29 607.24,-264.31"/>
+<text xml:space="preserve" text-anchor="middle" x="735.89" y="-244.45" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">run 
passes,</text>
+<text xml:space="preserve" text-anchor="middle" x="735.89" y="-234.7" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">CI files 
changed</text>
+</g>
+<!-- gate_bypassed -->
+<g id="node14" class="node">
+<title>gate_bypassed</title>
+<path fill="#fde8e8" stroke="#b54848" d="M1014.12,-125.75C1014.12,-125.75 
917.88,-125.75 917.88,-125.75 911.88,-125.75 905.88,-119.75 905.88,-113.75 
905.88,-113.75 905.88,-93.75 905.88,-93.75 905.88,-87.75 911.88,-81.75 
917.88,-81.75 917.88,-81.75 1014.12,-81.75 1014.12,-81.75 1020.12,-81.75 
1026.12,-87.75 1026.12,-93.75 1026.12,-93.75 1026.12,-113.75 1026.12,-113.75 
1026.12,-119.75 1020.12,-125.75 1014.12,-125.75"/>
+<text xml:space="preserve" text-anchor="middle" x="966" y="-111.3" 
font-family="Helvetica,sans-Serif" font-size="11.00">gate_bypassed</text>
+<text xml:space="preserve" text-anchor="middle" x="966" y="-99.3" 
font-family="Helvetica,sans-Serif" font-size="11.00">project CI ran 
without</text>
+<text xml:space="preserve" text-anchor="middle" x="966" y="-87.3" 
font-family="Helvetica,sans-Serif" font-size="11.00">use project ci 
(closed)</text>
+</g>
+<!-- running&#45;&gt;gate_bypassed -->
+<g id="edge21" class="edge">
+<title>running&#45;&gt;gate_bypassed</title>
+<path fill="none" stroke="#5b6b80" d="M898,-129.07C900.03,-128.35 
902.06,-127.63 904.1,-126.91"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="896.44,-133.34 904.7,-126.7 
894.11,-126.74 896.44,-133.34"/>
+<text xml:space="preserve" text-anchor="middle" x="881.6" y="-144.95" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">gate 
tampering</text>
+</g>
+<!-- failed&#45;&gt;running -->
+<g id="edge11" class="edge">
+<title>failed&#45;&gt;running</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M676.29,-126.1C666.82,-133.7 661.1,-143 666.5,-153.5 669.29,-158.93 
673.23,-163.78 677.73,-168.05"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="675.19,-170.49 685.14,-174.15 
679.65,-165.09 675.19,-170.49"/>
+<text xml:space="preserve" text-anchor="middle" x="695.75" y="-144.95" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
pushes</text>
+</g>
+<!-- gate_modified -->
+<g id="node13" class="node">
+<title>gate_modified</title>
+<path fill="#fde8e8" stroke="#b54848" d="M788.25,-36C788.25,-36 653.75,-36 
653.75,-36 647.75,-36 641.75,-30 641.75,-24 641.75,-24 641.75,-12 641.75,-12 
641.75,-6 647.75,0 653.75,0 653.75,0 788.25,0 788.25,0 794.25,0 800.25,-6 
800.25,-12 800.25,-12 800.25,-24 800.25,-24 800.25,-30 794.25,-36 788.25,-36"/>
+<text xml:space="preserve" text-anchor="middle" x="721" y="-19.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">gate_modified</text>
+<text xml:space="preserve" text-anchor="middle" x="721" y="-7.55" 
font-family="Helvetica,sans-Serif" font-size="11.00">PR changes the gate 
(closed)</text>
+</g>
+<!-- failed&#45;&gt;gate_modified -->
+<g id="edge20" class="edge">
+<title>failed&#45;&gt;gate_modified</title>
+<path fill="none" stroke="#5b6b80" d="M721,-73.75C721,-65.35 721,-56.19 
721,-47.8"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="724.5,-47.97 721,-37.97 
717.5,-47.97 724.5,-47.97"/>
+<text xml:space="preserve" text-anchor="middle" x="763.75" y="-55.2" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">PR changes 
the gate</text>
+</g>
+<!-- green&#45;&gt;running -->
+<g id="edge12" class="edge">
+<title>green&#45;&gt;running</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M217,-241.32C224.45,-238.27 232,-235.59 239.5,-233.5 317.62,-211.72 
523.42,-224.68 604,-215.5 620.58,-213.61 638.35,-210.82 654.91,-207.89"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="655.46,-211.35 664.67,-206.11 
654.2,-204.46 655.46,-211.35"/>
+<text xml:space="preserve" text-anchor="middle" x="268.75" y="-239.57" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
pushes</text>
+</g>
+<!-- green_author_draft -->
+<g id="node7" class="node">
+<title>green_author_draft</title>
+<path fill="#e6f4ea" stroke="#3d8b57" d="M162.62,-211.5C162.62,-211.5 
69.38,-211.5 69.38,-211.5 63.37,-211.5 57.38,-205.5 57.38,-199.5 57.38,-199.5 
57.38,-187.5 57.38,-187.5 57.38,-181.5 63.38,-175.5 69.38,-175.5 69.38,-175.5 
162.62,-175.5 162.62,-175.5 168.62,-175.5 174.62,-181.5 174.62,-187.5 
174.62,-187.5 174.62,-199.5 174.62,-199.5 174.62,-205.5 168.62,-211.5 
162.62,-211.5"/>
+<text xml:space="preserve" text-anchor="middle" x="116" y="-195.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">the author&#39;s 
draft</text>
+<text xml:space="preserve" text-anchor="middle" x="116" y="-183.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">author marks it 
ready</text>
+</g>
+<!-- green&#45;&gt;green_author_draft -->
+<g id="edge7" class="edge">
+<title>green&#45;&gt;green_author_draft</title>
+<path fill="none" stroke="#5b6b80" d="M76.53,-274.66C67.17,-269.22 
58.65,-262.14 53,-253 44.83,-239.77 53.74,-227.62 67.18,-217.86"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="68.77,-221 75.27,-212.63 
64.97,-215.13 68.77,-221"/>
+<text xml:space="preserve" text-anchor="middle" x="84.5" y="-244.45" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
converts</text>
+<text xml:space="preserve" text-anchor="middle" x="84.5" y="-234.7" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">to 
draft</text>
+</g>
+<!-- ungated -->
+<g id="node12" class="node">
+<title>ungated</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M1042,-211.5C1042,-211.5 918,-211.5 
918,-211.5 912,-211.5 906,-205.5 906,-199.5 906,-199.5 906,-187.5 906,-187.5 
906,-181.5 912,-175.5 918,-175.5 918,-175.5 1042,-175.5 1042,-175.5 1048,-175.5 
1054,-181.5 1054,-187.5 1054,-187.5 1054,-199.5 1054,-199.5 1054,-205.5 
1048,-211.5 1042,-211.5"/>
+<text xml:space="preserve" text-anchor="middle" x="980" y="-195.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">ungated</text>
+<text xml:space="preserve" text-anchor="middle" x="980" y="-183.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">base branch without fork 
CI</text>
+</g>
+<!-- green&#45;&gt;ungated -->
+<g id="edge19" class="edge">
+<title>green&#45;&gt;ungated</title>
+<path fill="none" stroke="#5b6b80" d="M898,-255.24C901.18,-254.53 
903.87,-253.78 906,-253 924.92,-246.06 942.74,-232.27 956.16,-219.83"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="958.48,-222.46 963.22,-212.98 
953.6,-217.43 958.48,-222.46"/>
+<text xml:space="preserve" text-anchor="middle" x="979.47" y="-239.57" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">base without 
fork CI</text>
+</g>
+<!-- green_author_draft&#45;&gt;green -->
+<g id="edge8" class="edge">
+<title>green_author_draft&#45;&gt;green</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M118.66,-211.78C120.85,-226.02 124,-246.51 126.57,-263.21"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="123.11,-263.72 128.09,-273.07 
130.03,-262.66 123.11,-263.72"/>
+<text xml:space="preserve" text-anchor="middle" x="151.47" y="-244.45" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
marks</text>
+<text xml:space="preserve" text-anchor="middle" x="151.47" y="-234.7" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">it 
ready</text>
+</g>
+<!-- green_unverified&#45;&gt;running -->
+<g id="edge13" class="edge">
+<title>green_unverified&#45;&gt;running</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M596,-243.6C603.57,-240.1 611.14,-236.69 618.5,-233.5 632.35,-227.49 
647.45,-221.46 661.7,-216"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="662.87,-219.3 670.99,-212.49 
660.39,-212.76 662.87,-219.3"/>
+<text xml:space="preserve" text-anchor="middle" x="647.75" y="-239.57" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
pushes</text>
+</g>
+<!-- unverified_author_draft -->
+<g id="node9" class="node">
+<title>unverified_author_draft</title>
+<path fill="#fff6db" stroke="#b38a1d" d="M541.62,-211.5C541.62,-211.5 
448.38,-211.5 448.38,-211.5 442.38,-211.5 436.38,-205.5 436.38,-199.5 
436.38,-199.5 436.38,-187.5 436.38,-187.5 436.38,-181.5 442.38,-175.5 
448.38,-175.5 448.38,-175.5 541.62,-175.5 541.62,-175.5 547.62,-175.5 
553.62,-181.5 553.62,-187.5 553.62,-187.5 553.62,-199.5 553.62,-199.5 
553.62,-205.5 547.62,-211.5 541.62,-211.5"/>
+<text xml:space="preserve" text-anchor="middle" x="495" y="-195.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">the author&#39;s 
draft</text>
+<text xml:space="preserve" text-anchor="middle" x="495" y="-183.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">author marks it 
ready</text>
+</g>
+<!-- green_unverified&#45;&gt;unverified_author_draft -->
+<g id="edge9" class="edge">
+<title>green_unverified&#45;&gt;unverified_author_draft</title>
+<path fill="none" stroke="#5b6b80" d="M454.11,-274.64C445.29,-269.09 
437.17,-261.98 432,-253 424.38,-239.75 432.93,-227.75 445.94,-218.11"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="447.8,-221.07 454.24,-212.65 
443.96,-215.21 447.8,-221.07"/>
+<text xml:space="preserve" text-anchor="middle" x="463.5" y="-244.45" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
converts</text>
+<text xml:space="preserve" text-anchor="middle" x="463.5" y="-234.7" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">to 
draft</text>
+</g>
+<!-- released -->
+<g id="node11" class="node">
+<title>released</title>
+<path fill="#f2f4f7" stroke="#5b6b80" d="M1239.62,-211.5C1239.62,-211.5 
1098.38,-211.5 1098.38,-211.5 1092.38,-211.5 1086.38,-205.5 1086.38,-199.5 
1086.38,-199.5 1086.38,-187.5 1086.38,-187.5 1086.38,-181.5 1092.38,-175.5 
1098.38,-175.5 1098.38,-175.5 1239.62,-175.5 1239.62,-175.5 1245.62,-175.5 
1251.62,-181.5 1251.62,-187.5 1251.62,-187.5 1251.62,-199.5 1251.62,-199.5 
1251.62,-205.5 1245.62,-211.5 1239.62,-211.5"/>
+<text xml:space="preserve" text-anchor="middle" x="1169" y="-195.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">released</text>
+<text xml:space="preserve" text-anchor="middle" x="1169" y="-183.05" 
font-family="Helvetica,sans-Serif" font-size="11.00">maintainer added use 
project ci</text>
+</g>
+<!-- green_unverified&#45;&gt;released -->
+<g id="edge18" class="edge">
+<title>green_unverified&#45;&gt;released</title>
+<path fill="none" stroke="#5b6b80" d="M898,-267.79C966.76,-267.38 
1029.27,-264.18 1068,-253 1092.87,-245.82 1118.07,-231.24 1137.07,-218.44"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="1138.95,-221.39 
1145.17,-212.81 1134.96,-215.64 1138.95,-221.39"/>
+<text xml:space="preserve" text-anchor="middle" x="1144.8" y="-244.45" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">maintainer 
adds</text>
+<text xml:space="preserve" text-anchor="middle" x="1144.8" y="-234.7" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">use project 
ci</text>
+</g>
+<!-- unverified_author_draft&#45;&gt;green_unverified -->
+<g id="edge10" class="edge">
+<title>unverified_author_draft&#45;&gt;green_unverified</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M497.17,-211.94C497.91,-218.67 498.64,-226.43 499,-233.5 499.5,-243.2 
499.62,-253.81 499.58,-263.31"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="496.09,-263.03 499.48,-273.07 
503.09,-263.11 496.09,-263.03"/>
+<text xml:space="preserve" text-anchor="middle" x="526.18" y="-244.45" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">author 
marks</text>
+<text xml:space="preserve" text-anchor="middle" x="526.18" y="-234.7" 
font-family="Helvetica,sans-Serif" font-size="9.00" fill="#33404d">it 
ready</text>
+</g>
+<!-- closed&#45;&gt;awaiting_push -->
+<g id="edge17" class="edge">
+<title>closed&#45;&gt;awaiting_push</title>
+<path fill="none" stroke="#5b6b80" stroke-dasharray="5,2" 
d="M1359.89,-215.83C1352.46,-228.94 1341.05,-244.76 1326,-253 1289.8,-272.84 
1036.25,-284.48 901.6,-289.33"/>
+<polygon fill="#5b6b80" stroke="#5b6b80" points="909.05,-284.97 899.5,-289.57 
909.83,-291.92 909.05,-284.97"/>
+<text xml:space="preserve" text-anchor="middle" x="1366.72" y="-239.57" 
font-family="Helvetica,sans-Serif" font-size="9.00" 
fill="#33404d">reopened</text>
+</g>
+</g>
+</svg>

Reply via email to