LibreChat/.github/workflows/codegraph-e2e-votes.yml
Danny Avila d32403f851
Some checks failed
Backend Unit Tests / Build packages (push) Waiting to run
Backend Unit Tests / Codegraph select (push) Waiting to run
Backend Unit Tests / TypeScript type checks (push) Blocked by required conditions
Backend Unit Tests / Circular dependency checks (push) Waiting to run
Backend Unit Tests / Tests: api (shard 1/3) (push) Blocked by required conditions
Backend Unit Tests / Tests: api (shard 2/3) (push) Blocked by required conditions
Backend Unit Tests / Tests: api (shard 3/3) (push) Blocked by required conditions
Backend Unit Tests / Tests: data-provider (push) Blocked by required conditions
Backend Unit Tests / Tests: data-schemas (push) Blocked by required conditions
Backend Unit Tests / Tests: @librechat/api (shard 1/4) (push) Blocked by required conditions
Backend Unit Tests / Tests: @librechat/api (shard 2/4) (push) Blocked by required conditions
Backend Unit Tests / Tests: @librechat/api (shard 3/4) (push) Blocked by required conditions
Backend Unit Tests / Tests: @librechat/api (shard 4/4) (push) Blocked by required conditions
Channel Gateway / gateway (push) Waiting to run
Codegraph E2E Vote Gate / Gate (push) Waiting to run
Codegraph E2E Votes / vote (shard 1/10) (push) Waiting to run
Codegraph E2E Votes / vote (shard 10/10) (push) Waiting to run
Codegraph E2E Votes / vote (shard 2/10) (push) Waiting to run
Codegraph E2E Votes / vote (shard 3/10) (push) Waiting to run
Codegraph E2E Votes / vote (shard 4/10) (push) Waiting to run
Codegraph E2E Votes / vote (shard 5/10) (push) Waiting to run
Codegraph E2E Votes / vote (shard 6/10) (push) Waiting to run
Codegraph E2E Votes / vote (shard 7/10) (push) Waiting to run
Codegraph E2E Votes / vote (shard 8/10) (push) Waiting to run
Codegraph E2E Votes / vote (shard 9/10) (push) Waiting to run
Docker Dev Branch Images Build / publish (push) Waiting to run
Frontend Unit Tests / Client build recovery regression (push) Waiting to run
Frontend Unit Tests / Codegraph select (push) Waiting to run
Frontend Unit Tests / Build packages (push) Waiting to run
Frontend Unit Tests / TypeScript type checks (client) (push) Blocked by required conditions
Frontend Unit Tests / Tests: @librechat/chat (push) Blocked by required conditions
Frontend Unit Tests / Tests: @librechat/client (push) Blocked by required conditions
Frontend Unit Tests / Tests: Ubuntu (shard 1/2) (push) Blocked by required conditions
Frontend Unit Tests / Tests: Ubuntu (shard 2/2) (push) Blocked by required conditions
Frontend Unit Tests / Vite build verification (push) Blocked by required conditions
Playwright E2E Tests / Codegraph select (push) Waiting to run
Playwright E2E Tests / e2e () (push) Blocked by required conditions
Playwright E2E Tests / MCP list_changed (replica count 1) (push) Blocked by required conditions
Playwright E2E Tests / MCP list_changed (replica count 2) (push) Blocked by required conditions
Playwright E2E Tests / MCP Apps (browser and server) (push) Waiting to run
Playwright E2E Tests / e2e (push) Blocked by required conditions
Main Promotion Policy Tests / Main promotion denial and fast-forward tests (push) Waiting to run
Sync Locize Translations & Create Translation PR / Sync Translation Keys with Locize (push) Has been cancelled
Sync Locize Translations & Create Translation PR / Create Translation PR on Version Published (push) Has been cancelled
🍃 ci: Provision the mongod Binary Before Any Test Starts (#18053)
* 🍃 ci: Provision the mongod Binary Before Tests Start

mongodb-memory-server downloads its ~122 MB mongod the first time a test
starts a server, inside a 15 s beforeAll. Only backend-review.yml cached
~/.cache/mongodb-binaries (the same step pasted four times), and a cache
alone still leaves the download inside the first hook on a miss.

Integration Tests downloaded on every run: 6 failures in 274 runs with
"Exceeded timeout of 15000 ms for a hook" in secrets.integration.spec.ts,
followed by "spawn ETXTBSY" in the suites that started mongod while the
timed-out download was still writing it.

Add .github/actions/mongodb-binary: restore the cache with the existing
key scheme, ask the installed mongodb-memory-server for the binary it
wants (MongoBinary.getPath), make sure that binary sits in the home cache
every working directory resolves, run it once, and save the cache right
away. The step fails the job when no runnable binary can be put in place.

Use it in every job that starts mongodb-memory-server, after dependencies
are installed and before tests, and add the action to the path filters of
the workflows that list their own file.

* 🧪 test: Cover the mongod Provisioning Script Without the Network

Run the real script against a stand-in resolver that keeps the properties it relies on: home cache first, download when missing, and a memoised path until the cache is cleared. Integration Tests runs the suite before it uses the action.

* 🧪 test: Run mongod Provisioning Against the Real Resolver

The suite replaced mongodb-memory-server with a hand-written stand-in, so
it checked the script against a description of the resolver rather than the
installed one. It now runs the script against the real library and
replaces only the network: MONGOMS_DOWNLOAD_MIRROR points at a local
server that serves an archive whose bin/mongod is a shell script, with the
.md5 the library verifies it against.

Recovery also no longer charges a broken copy that was already on disk to
the download: with a broken binary in both the home cache and the root
node_modules/.cache, the first attempt removed one, the retry met the
other, and the step failed without ever downloading. Existing copies are
now discarded one at a time and the download keeps its own two attempts.

* 🧪 test: Reach the Exit-Status Check Behind the Library's System Binary Probe

A system binary that prints nothing is rejected by the library's own version probe, so the case never reached this script's check or the rule that a file the job named is not deleted. Add one that answers the probe and exits non-zero.
2026-11-11 10:31:46 -05:00

299 lines
16 KiB
YAML

# Codegraph e2e VOTES — observe-only, post-merge, time-boxed.
#
# Evidence for the e2e skip election would otherwise wait on rare organic PR spec failures, so
# this workflow runs the FULL mock suite after merges: each run is one graduation trial for
# every spec it executes. It is not the post-merge safety net: its test step cannot fail (see
# below), so a regression on dev leaves it green. The run that goes red is playwright-mock.yml's
# own dev-push trigger.
#
# By default every merge votes (the push trigger). Each run costs about 154 job-minutes on ten
# runners, so with repo variable CODEGRAPH_E2E_VOTE_MIN_HOURS set to N > 0 a push run votes
# nothing: its job is skipped and codegraph-e2e-vote-gate.yml starts this workflow on dev
# (workflow_dispatch) at most once per N hours, catching up hourly on the newest merge once the
# window opens (rules in .github/scripts/vote-gate.mjs). A handed-off push run takes a
# concurrency group of its own, so it neither waits behind a vote nor replaces the pending one.
# Leave run-name unset: the codegraph shadow matches vote runs by this workflow's name.
#
# It previously ran only the merged PR's skippable tier, passing the tier as CLI path
# filters. playwright.config.mock.ts scopes discovery to testDir specs/mock/, so tier
# entries outside that directory matched nothing — and the covered-list log line still
# claimed them, minting graduation trials for specs that never executed (run 32701691037:
# a11y/keys/messages in the covered list, zero of their tests run). The covered list below
# is therefore derived from the run's EXECUTED results — discovery is not enough either,
# since env-gated suites self-skip under this job's default env — and the run takes no
# path filters at all.
#
# It cannot fail the branch: the test step is continue-on-error. A vote run is never
# cancelled once it starts, because only a finished run is a trial: while each merge
# cancelled the run before it (dev merges every few minutes, the suite takes ~43 min), 480
# of 499 runs from 2026-09-24 never finished and graduation evidence stopped at 09-30. One
# run proceeds and the newest merge waits as the single pending run. The whole campaign
# switches off by setting repo variable CODEGRAPH_E2E_VOTES=off once the election passes.
#
# The suite runs as duration-planned shards, one runner each, the way playwright-mock.yml's
# memory shards do: on one runner with one worker it grew from 375 tests in 39.1 min
# (2026-09-30) to 1,321 tests, and run 39682542347 reached 570 of them when its 75-minute
# timeout cancelled it, so no vote finished after 09-30. Every shard plans the same disjoint
# partition (.github/scripts/playwright-shards.mjs over e2e/timings.mock.json), so the
# shards together still run the whole suite and the run is still ONE trial: the codegraph
# shadow unions the specs each shard's ledger logged. A shard that never logs its ledger
# (setup failed) adds no spec to the trial, so it can mint no clean trial for the specs it
# would have run. Each shard's test step has its own time budget below the job's, so a slow
# shard ends as a shard that ran out of time; a job timeout would cancel the whole run, and
# the shadow reads a cancelled run as no trial. A shard that ran out of time still logs the
# specs that FAILED: failing tests run three times, so a regression is what pushes a shard
# past its budget, and dropping that shard would drop exactly the failure the votes exist to
# catch. Its clean specs are not logged (not all of their tests ran), and the shadow ages
# each spec by its own newest observation, so a shard that never finishes stops its specs'
# skips instead of hiding behind the other shards' fresh votes.
name: Codegraph E2E Votes
on:
push:
branches:
- dev
paths:
- '**'
- '!**.md'
- '!.github/workflows/**'
- '.github/workflows/codegraph-e2e-votes.yml'
- '.github/workflows/codegraph-e2e-vote-gate.yml'
workflow_dispatch:
permissions:
contents: read
concurrency:
group: ${{ github.event_name == 'push' && vars.CODEGRAPH_E2E_VOTE_MIN_HOURS != '' && vars.CODEGRAPH_E2E_VOTE_MIN_HOURS != '0' && format('codegraph-e2e-votes-handoff-{0}', github.run_id) || 'codegraph-e2e-votes' }}
cancel-in-progress: false
env:
NODE_OPTIONS: '--max-old-space-size=6144'
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: '1'
jobs:
vote:
name: vote (shard ${{ matrix.shard }}/10)
# A push run votes only while the throttle is off; with it on, the gate starts the votes.
if: >-
vars.CODEGRAPH_E2E_VOTES != 'off' &&
github.ref == 'refs/heads/dev' &&
(github.event_name != 'push' || vars.CODEGRAPH_E2E_VOTE_MIN_HOURS == '' || vars.CODEGRAPH_E2E_VOTE_MIN_HOURS == '0')
runs-on: ubuntu-latest
# Sized from e2e/timings.mock.json: 8,033 recorded seconds over 10 shards plans ~13.4 min
# of tests per shard. Scored against two held-out PR runs of 2026-11-03 (same plan, same
# workers: 1), the slowest shard measured 14.2-14.5 min, and the single vote job ran
# ~7.7 s per test (17 min for a tenth of 1,321). VOTE_TEST_MINUTES gives the tests 28 min
# (2.1x the plan); the job adds setup (about 2.5 min with npm ci, 70 s of it) and margin.
timeout-minutes: 40
# Separate runners isolate each shard's user, MongoDB and fixture state. Keep workers: 1
# in Playwright; shared-user cleanup is not worker-safe.
strategy:
fail-fast: false
matrix:
shard: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
env:
CI: 'true'
E2E_CHROMIUM_CHANNEL: chrome
E2E_STREAM_STORE: memory
VOTE_SHARD: ${{ matrix.shard }}/10
VOTE_TEST_MINUTES: '28'
steps:
- uses: actions/checkout@v5
- name: Use Node.js 24.22.1
uses: actions/setup-node@v5
with:
node-version: '24.22.1'
- name: Restore node_modules cache
id: cache-node-modules
uses: actions/cache@v5
with:
path: |
node_modules
client/node_modules
packages/client/node_modules
packages/chat/node_modules
packages/data-provider/node_modules
packages/data-schemas/node_modules
packages/api/node_modules
packages/channel-gateway/node_modules
api/node_modules
key: node-modules-e2e-${{ runner.os }}-24.22.1-${{ hashFiles('package-lock.json') }}
- name: Install dependencies
if: steps.cache-node-modules.outputs.cache-hit != 'true'
run: npm ci
- name: Restore data-provider build cache
id: cache-data-provider
uses: actions/cache@v5
with:
path: packages/data-provider/dist
key: build-data-provider-${{ runner.os }}-${{ hashFiles('package.json', 'package-lock.json', 'packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json') }}
- name: Build data-provider
if: steps.cache-data-provider.outputs.cache-hit != 'true'
run: npm run build:data-provider
- name: Restore data-schemas build cache
id: cache-data-schemas
uses: actions/cache@v5
with:
path: packages/data-schemas/dist
key: build-data-schemas-${{ runner.os }}-${{ hashFiles('package.json', 'package-lock.json', 'packages/data-schemas/src/**', 'packages/data-schemas/tsconfig*.json', 'packages/data-schemas/tsdown.config.mjs', 'packages/data-schemas/package.json', 'packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json') }}
- name: Build data-schemas
if: steps.cache-data-schemas.outputs.cache-hit != 'true'
run: npm run build:data-schemas
- name: Restore api build cache
id: cache-api
uses: actions/cache@v5
with:
path: packages/api/dist
key: build-api-${{ runner.os }}-${{ hashFiles('package.json', 'package-lock.json', 'packages/api/src/**', 'packages/api/tsconfig*.json', 'packages/api/tsdown.config.mjs', 'packages/api/package.json', 'packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json', 'packages/data-schemas/src/**', 'packages/data-schemas/tsconfig*.json', 'packages/data-schemas/tsdown.config.mjs', 'packages/data-schemas/package.json') }}
- name: Build api
if: steps.cache-api.outputs.cache-hit != 'true'
run: npm run build:api
- name: Restore client-package build cache
id: cache-client-package
uses: actions/cache@v5
with:
path: packages/client/dist
key: build-client-package-${{ runner.os }}-${{ hashFiles('package.json', 'package-lock.json', 'packages/client/src/**', 'packages/client/tsconfig*.json', 'packages/client/tsdown.config.mjs', 'packages/client/package.json', 'packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json') }}
- name: Build client-package
if: steps.cache-client-package.outputs.cache-hit != 'true'
run: npm run build:client-package
# About a second, so it is not cached; the client app imports the built entries.
- name: Build chat package
run: npm run build:chat
- name: Restore client app build cache
id: cache-client-app
uses: actions/cache@v5
with:
path: client/dist
key: build-client-app-e2e-${{ runner.os }}-${{ hashFiles('package.json', 'package-lock.json', 'client/src/**', 'client/public/**', 'client/index.html', 'client/package.json', 'client/vite.config.*', 'client/tsconfig*.json', 'client/tailwind.config.*', 'client/postcss.config.*', 'packages/client/src/**', 'packages/chat/src/**', 'packages/client/tailwind.preset.cjs', 'packages/client/tsconfig*.json', 'packages/client/tsdown.config.mjs', 'packages/client/package.json', 'packages/data-provider/src/**', 'packages/data-provider/tsconfig*.json', 'packages/data-provider/tsdown.config.mjs', 'packages/data-provider/package.json') }}
- name: Build client app
if: steps.cache-client-app.outputs.cache-hit != 'true'
run: npm run build:client
- name: Provision MongoDB memory-server binary
uses: ./.github/actions/mongodb-binary
- name: Verify Chrome is present
run: google-chrome --version
# ffmpeg for retry video — see the note in playwright-mock.yml.
- name: Resolve Playwright version
id: playwright-version
run: |
version=$(node -p "require('./package-lock.json').packages['node_modules/playwright-core'].version")
echo "version=${version}" >> "$GITHUB_OUTPUT"
- name: Restore Playwright ffmpeg cache
id: cache-ffmpeg
uses: actions/cache/restore@v5
with:
path: ~/.cache/ms-playwright
key: playwright-ffmpeg-${{ runner.os }}-${{ steps.playwright-version.outputs.version }}
- name: Install Playwright ffmpeg (best effort)
id: install-ffmpeg
if: steps.cache-ffmpeg.outputs.cache-hit != 'true'
timeout-minutes: 3
continue-on-error: true
run: |
timeout -k 10 60 npx playwright install ffmpeg
.github/scripts/verify-playwright-ffmpeg.sh
- name: Save Playwright ffmpeg cache
if: steps.install-ffmpeg.outcome == 'success'
continue-on-error: true
uses: actions/cache/save@v5
with:
path: ~/.cache/ms-playwright
key: playwright-ffmpeg-${{ runner.os }}-${{ steps.playwright-version.outputs.version }}
# Optional fonts only — see the note in playwright-mock.yml.
- name: Install optional Playwright font dependencies (best effort)
timeout-minutes: 4
continue-on-error: true
run: .github/scripts/install-playwright-fonts.sh
# The plan is playwright-mock.yml's: list the suite, assign whole spec files longest
# first to the least-loaded shard by recorded duration. No --skip (votes run every spec,
# graduated or not: they are the net that catches a wrong skip) and no --reserve (vote
# shards run nothing after the suite).
#
# The tests run under `timeout`, not the step's timeout-minutes, so the ledger can tell
# a shard that ran out of time from one whose tests failed: an interrupted shard's
# results would claim specs whose tests never all ran.
- name: Vote — run this shard of the mock suite (cannot fail the branch)
continue-on-error: true
run: |
PLAYWRIGHT_JSON_OUTPUT_FILE=e2e/.generated/playwright-list.json \
npx playwright test --config=e2e/playwright.config.mock.ts --list --reporter=json > /dev/null
node .github/scripts/playwright-shards.mjs plan \
--list e2e/.generated/playwright-list.json \
--timings e2e/timings.mock.json \
--shard "$VOTE_SHARD" \
--out e2e/.generated/shard-tests.txt
# PLAYWRIGHT_JSON_OUTPUT_NAME is absolute on purpose: Playwright resolves a relative
# one against the CONFIG directory (e2e/), not the working directory — the first live
# run wrote e2e/pw-results.json while the ledger looked in the repo root and logged
# zero trials (fail-safe, but a silent no-op).
set +e
PLAYWRIGHT_JSON_OUTPUT_NAME="$GITHUB_WORKSPACE/pw-results.json" \
timeout --signal=INT --kill-after=60 "${VOTE_TEST_MINUTES}m" \
npx playwright test --config=e2e/playwright.config.mock.ts \
--test-list=e2e/.generated/shard-tests.txt --reporter=line,json
rc=$?
if [ "$rc" -eq 124 ] || [ "$rc" -eq 137 ]; then
touch "$GITHUB_WORKSPACE/vote-timed-out"
echo "::warning::shard $VOTE_SHARD ran out of its ${VOTE_TEST_MINUTES}-minute test budget"
fi
exit "$rc"
- name: Ledger — log the specs that actually executed
run: |
set +e
# The shadow's per-spec graduation ledger counts a clean trial for every spec a green
# run covered, so the covered list must come from EXECUTED tests, not from discovery:
# env-gated suites (mcp-tool-list-changed needs E2E_MCP_LIST_CHANGED, enforced-model-
# specs needs E2E_MODEL_SPECS_ENFORCE) are discovered by --list yet skip every test
# under this job's default env — counting them as covered would mint phantom trials,
# the exact bug this workflow revision exists to kill (Codex P1 on #15162). A spec is
# covered iff at least one of its tests reached a non-skipped outcome. Each shard logs
# only what it executed; the shadow unions the shards of one run into one trial. A
# shard that ran out of time logs no clean spec (not all of their tests ran), only
# the specs with a test Playwright counts as failed (outcome unexpected: every
# attempt that finished failed), so the shadow records them as failed trials.
if [ -e "$GITHUB_WORKSPACE/vote-timed-out" ]; then
echo "codegraph-votes: shard $VOTE_SHARD ran out of time — only its failures logged"
if jq -e '.suites' "$GITHUB_WORKSPACE/pw-results.json" >/dev/null 2>&1; then
jq -r '[.suites[] | recurse(.suites[]?) | .specs[]? | select(any(.tests[]?; .status == "unexpected")) | .file] | unique | .[]' "$GITHUB_WORKSPACE/pw-results.json" \
| sed 's|^|specs/mock/|' > failed.txt
if [ -s failed.txt ]; then echo "codegraph-votes-failed: $(tr '\n' ' ' < failed.txt)"; fi
fi
elif jq -e '.suites' "$GITHUB_WORKSPACE/pw-results.json" >/dev/null 2>&1; then
jq -r '[.suites[] | recurse(.suites[]?) | .specs[]? | select([.tests[]?.status] | any(. != "skipped")) | .file] | unique | .[]' "$GITHUB_WORKSPACE/pw-results.json" \
| sed 's|^|specs/mock/|' > covered.txt
N=$(wc -l < covered.txt | tr -d ' ')
echo "codegraph-votes: running $N specs (executed, shard $VOTE_SHARD)"
if [ "$N" != "0" ]; then echo "codegraph-votes-specs: $(tr '\n' ' ' < covered.txt)"; fi
else
echo "codegraph-votes: no results json — shard $VOTE_SHARD crashed before reporting; no trials logged"
fi
exit 0
- name: Done
if: always()
run: 'echo "codegraph-votes: complete"'