From d1573eb2c2332ce6d18380593c8280fa3b3b946a Mon Sep 17 00:00:00 2001 From: Etienne Filhol Date: Thu, 19 Nov 2026 13:56:15 +0100 Subject: [PATCH 1/2] ci(ci): skip the tests workflow on draft pull requests Run it again when a draft is marked ready, and keep the manual trigger. The PR judge already skips drafts. --- .github/workflows/tests.yml | 12 +++++++----- AGENTS.md | 7 ++++--- 2 files changed, 11 insertions(+), 8 deletions(-) diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index b73f2eda..bca32921 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -1,8 +1,8 @@ -# The application's two suites and installable package, on every PR and by -# hand. There are no model calls or containers: the docker tier is the -# nightly docker-tests workflow. Hosted runner time uses -# the account's Actions allowance. uv is a test tool; Flask is the app's -# only Python dependency. +# The application's two suites and installable package, on every non-draft PR +# (again when a draft is marked ready) and by hand. There are no model calls +# or containers: the docker tier is the nightly docker-tests workflow. Hosted +# runner time uses the account's Actions allowance. uv is a test tool; Flask +# is the app's only Python dependency. # # Nothing shared is installed, because nothing shared is imported: the backend # is this repository's own code under app/nullius/ and imports only the @@ -12,6 +12,7 @@ name: tests on: pull_request: + types: [opened, synchronize, reopened, ready_for_review] workflow_dispatch: permissions: @@ -23,6 +24,7 @@ concurrency: jobs: tests: + if: github.event_name != 'pull_request' || !github.event.pull_request.draft runs-on: ubuntu-latest timeout-minutes: 10 env: diff --git a/AGENTS.md b/AGENTS.md index 9be3711f..5da61d9a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -216,9 +216,10 @@ Debug mode is off by default. Use `--debug` only for development; `--no-debug` overrides an explicit `DEBUG=1` environment setting. **CI** runs the experimental PR judge, backend and route suites, and a temporary -wheel install/reinstall check on pull requests. `app/packaging/verify.py` checks -runtime assets, one backend provider, installed commands and pages, and user -storage preservation. The `tests` workflow also runs by hand. +wheel install/reinstall check on non-draft pull requests (again when one is +marked ready). `app/packaging/verify.py` checks runtime assets, one backend +provider, installed commands and pages, and user storage preservation. The +`tests` workflow also runs by hand. The manual `draft release` workflow (`.github/workflows/release.yml`) runs both suites and uses `app/packaging/release.py` to build and verify a release's wheel and source archive, then attaches them and `SHA256SUMS` to a draft From 797402745baab01fcd3ad706163987dd9ca1fa8e Mon Sep 17 00:00:00 2001 From: Etienne Filhol Date: Thu, 19 Nov 2026 14:17:45 +0100 Subject: [PATCH 2/2] docs: list the CI workflows one line each in AGENTS.md --- AGENTS.md | 37 +++++++++++++++---------------------- 1 file changed, 15 insertions(+), 22 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 5da61d9a..6ba4ab10 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -215,28 +215,21 @@ PYTHONPATH=app python3 -m nullius.importers.cli --list Debug mode is off by default. Use `--debug` only for development; `--no-debug` overrides an explicit `DEBUG=1` environment setting. -**CI** runs the experimental PR judge, backend and route suites, and a temporary -wheel install/reinstall check on non-draft pull requests (again when one is -marked ready). `app/packaging/verify.py` checks runtime assets, one backend -provider, installed commands and pages, and user storage preservation. The -`tests` workflow also runs by hand. -The manual `draft release` workflow (`.github/workflows/release.yml`) runs both -suites and uses `app/packaging/release.py` to build and verify a release's -wheel and source archive, then attaches them and `SHA256SUMS` to a draft -release (a prerelease for an `rc` tag). It does not publish or upload to PyPI; see -`app/packaging/README.md` and the versioned notes under `docs/releases/`. -The separate manual `publish to PyPI` workflow (`.github/workflows/publish.yml`) -requires confirmation and a reviewed, published GitHub release. It verifies -the downloaded assets before a separate `pypi` environment job uploads the -same bytes through Trusted Publishing. PyPI and environment configuration -must be completed before that workflow can publish. -The `docker tests` workflow (`.github/workflows/docker-tests.yml`) builds the -standard's base image and runs the backend suite with the docker tier, nightly -and by hand, never on a pull request. The `documentation site` workflow -is run by hand and only checks: the host builds and publishes the site from -`docs-release`, advanced to the release tag only after the PyPI upload succeeds. -Preview deployments are disabled; `bash app/site/host-build.sh` is the same check locally. See -`app/site/README.md`. +**CI** (`.github/workflows/`): + +- `tests`: backend and route suites, actionlint, and a wheel install check + (`app/packaging/verify.py`). Non-draft pull requests, and by hand. +- `judge-pr`: the PR judge, below. Non-draft pull requests, and `/judge`. +- `docker-tests`: the backend suite with the docker tier. Nightly, and by hand. +- `draft release` (`release.yml`): builds and verifies a release's wheel and + source archive into a draft GitHub release. By hand; never publishes. +- `publish to PyPI` (`publish.yml`): uploads a reviewed, published release's + verified assets by Trusted Publishing. By hand, with confirmation. +- `documentation site`: checks the site build, by hand + (`bash app/site/host-build.sh` locally). The host publishes from + `docs-release`, advanced to the release tag after the PyPI upload. + +See `app/packaging/README.md`, `docs/releases/` and `app/site/README.md`. **UI checks:** routine interface changes require relevant unit and route tests plus focused browser checks of the affected pages and interactions, including