Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 7 additions & 5 deletions .github/workflows/tests.yml
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -12,6 +12,7 @@ name: tests

on:
pull_request:
types: [opened, synchronize, reopened, ready_for_review]
workflow_dispatch:

permissions:
Expand All @@ -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:
Expand Down
36 changes: 15 additions & 21 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -215,27 +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 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.
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
Expand Down