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 │ - └───────────────────────────────────────────┘ -``` + 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 --> [*] -``` + - **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 -``` + 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's fork (GitHub-hosted runners, contributor'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-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->ci --> +<g id="edge1" class="edge"> +<title>push->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 -> run</text> +</g> +<!-- ci->gatef --> +<g id="edge2" class="edge"> +<title>ci->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-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->bi --> +<g id="edge3" class="edge"> +<title>gatef->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->tests --> +<g id="edge4" class="edge"> +<title>bi->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-ci-reconcile</text> +</g> +<!-- tests->rec --> +<g id="edge9" class="edge"> +<title>tests->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 -> 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-info and all later jobs skipped)</text> +</g> +<!-- pr->gatea --> +<g id="edge5" class="edge"> +<title>pr->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-ci-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->rec --> +<g id="edge6" class="edge"> +<title>mon->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->out --> +<g id="edge7" class="edge"> +<title>rec->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 -> Slack</text> +</g> +<!-- rec->slack --> +<g id="edge8" class="edge"> +<title>rec->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->waiting --> +<g id="edge1" class="edge"> +<title>start->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->running --> +<g id="edge2" class="edge"> +<title>waiting->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->closed --> +<g id="edge21" class="edge"> +<title>waiting->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->waiting --> +<g id="edge3" class="edge"> +<title>running->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->failed --> +<g id="edge4" class="edge"> +<title>running->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->ready --> +<g id="edge5" class="edge"> +<title>running->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'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->authordraft --> +<g id="edge6" class="edge"> +<title>running->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->rebase --> +<g id="edge8" class="edge"> +<title>running->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->needs --> +<g id="edge9" class="edge"> +<title>running->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-defining files</text> +</g> +<!-- failed->running --> +<g id="edge10" class="edge"> +<title>failed->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->running --> +<g id="edge12" class="edge"> +<title>ready->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->project --> +<g id="edge17" class="edge"> +<title>ready->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->approved --> +<g id="edge15" class="edge"> +<title>ready->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->ready --> +<g id="edge7" class="edge"> +<title>authordraft->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->running --> +<g id="edge11" class="edge"> +<title>rebase->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->approved --> +<g id="edge16" class="edge"> +<title>rebase->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->running --> +<g id="edge13" class="edge"> +<title>needs->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->project --> +<g id="edge18" class="edge"> +<title>needs->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->approved --> +<g id="edge19" class="edge"> +<title>project->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->running --> +<g id="edge14" class="edge"> +<title>approved->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->merged --> +<g id="edge20" class="edge"> +<title>approved->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-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->done --> +<g id="edge23" class="edge"> +<title>merged->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->waiting --> +<g id="edge22" class="edge"> +<title>closed->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-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-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->setup_required --> +<g id="edge1" class="edge"> +<title>start->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->awaiting_push --> +<g id="edge2" class="edge"> +<title>setup_required->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->setup_required --> +<g id="edge15" class="edge"> +<title>awaiting_push->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->running --> +<g id="edge3" class="edge"> +<title>awaiting_push->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->closed --> +<g id="edge16" class="edge"> +<title>awaiting_push->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->setup_required --> +<g id="edge14" class="edge"> +<title>running->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->failed --> +<g id="edge4" class="edge"> +<title>running->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's draft)</text> +</g> +<!-- running->green --> +<g id="edge5" class="edge"> +<title>running->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's draft)</text> +</g> +<!-- running->green_unverified --> +<g id="edge6" class="edge"> +<title>running->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->gate_bypassed --> +<g id="edge21" class="edge"> +<title>running->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->running --> +<g id="edge11" class="edge"> +<title>failed->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->gate_modified --> +<g id="edge20" class="edge"> +<title>failed->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->running --> +<g id="edge12" class="edge"> +<title>green->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'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->green_author_draft --> +<g id="edge7" class="edge"> +<title>green->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->ungated --> +<g id="edge19" class="edge"> +<title>green->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->green --> +<g id="edge8" class="edge"> +<title>green_author_draft->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->running --> +<g id="edge13" class="edge"> +<title>green_unverified->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'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->unverified_author_draft --> +<g id="edge9" class="edge"> +<title>green_unverified->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->released --> +<g id="edge18" class="edge"> +<title>green_unverified->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->green_unverified --> +<g id="edge10" class="edge"> +<title>unverified_author_draft->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->awaiting_push --> +<g id="edge17" class="edge"> +<title>closed->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>
