From 1acc07d29f34a9ff76d0d492f15b6642d05aff85 Mon Sep 17 00:00:00 2001 From: Dariusz L Date: Sun, 2 Aug 2026 14:51:40 +0200 Subject: [PATCH] docs: describe external pull request checks --- docs/architecture.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/architecture.md b/docs/architecture.md index 9562638..47162e6 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -64,6 +64,23 @@ current statement, branch, and function coverage. It is an inspection report, not a hard threshold, because runtime-only ComfyUI adapters cannot be fully exercised outside the host application. +## Pull request checks + +The repository workflow lives in `.github/workflows/ci.yml`. It runs the +frontend and backend checks for pull requests whose source repository is +outside this repository, which keeps automated validation focused on external +contributions. It does not run for direct pushes to `main`; local changes by +the maintainer should use the verification commands above before committing. + +The workflow uses the tracked `package-lock.json` with `npm ci`, has read-only +repository permissions, and does not require secrets. Its two jobs run: + +1. `npm test` and `npm run lint` for the frontend. +2. `pytest`, Ruff, and `compileall` for the backend. + +The workflow uses `pull_request`, not `pull_request_target`, so code from an +external fork is tested with the restricted pull-request token context. + Run these commands with the same Python interpreter used by ComfyUI: ```powershell