diff --git a/quest/m0/ci/README.md b/quest/m0/ci/README.md index a96b59f8c93..91a5e25babd 100644 --- a/quest/m0/ci/README.md +++ b/quest/m0/ci/README.md @@ -153,6 +153,8 @@ The historical samples locate candidates; they are not controlled benchmarks. - [Read-only pull-request CI](/quest/m0/ci/read-only-secrets.md) - write secrets and publisher identities reach only protected branches and tags, never a pushed branch - [Land main through quest land](/quest/m0/ci/land.md) - a host daemon tests small batches of queued PRs once and lands each as its tested squash commit +- [A cache error is a miss](/quest/m0/ci/nix-cache-5xx.md) - a transient `nix.moq.dev` 5xx no longer fails `just ci` +- [Cheap checks skip the queue](/quest/m0/ci/gate-quick.md) - condition: quest ships `quest gate --quick`; then cheap modules wait at most a minute - [Gate each diff in under five minutes](/quest/m0/ci/five-minutes.md) - `just check` and `just test` each finish within a worker's 5-minute prompt cache, admission wait included - [Measure the parallel frontend](/quest/m0/ci/nightly-levers.md) - a pinned nightly's parallel frontend, adopted only if the numbers beat its risks; Cranelift is ruled out - [Verify the R2 Rust cache](/quest/m0/ci/mbx-r2-verify.md) - confirm the hosted Nightly jobs reuse the previous Nightly, then measure restore time and expiry diff --git a/quest/m0/ci/gate-quick.md b/quest/m0/ci/gate-quick.md new file mode 100644 index 00000000000..2e231a3431e --- /dev/null +++ b/quest/m0/ci/gate-quick.md @@ -0,0 +1,20 @@ +# [XS] Cheap checks run through quest gate --quick + +## Goal + +moq's cheap checks, such as `check quest`, the formatters, and markdown, +wait at most a short bounded time for `quest gate` admission instead of +queuing behind agent builds. + +## Plan + +Decided 2026-10-31 (user, /quest-plan of the follow-ups from moq-dev/quest's host-gate cutover for moq.pro and rust2 and its fixer repairs). + +- Condition: [moq-dev/quest#324](https://github.com/moq-dev/quest/pull/324) + lands, adding `quest gate --quick` (at most 60 seconds of admission wait), + and moq's flake pins a quest that includes it. +- Cheap checks waited up to an hour behind load + ([#7250](https://github.com/moq-dev/moq/pull/7250), + [#7257](https://github.com/moq-dev/moq/pull/7257)). Mark them in the + dispatcher's module table, not by command name, and leave builds and + test suites under normal admission. diff --git a/quest/m0/ci/nix-cache-5xx.md b/quest/m0/ci/nix-cache-5xx.md new file mode 100644 index 00000000000..52c5841c9f1 --- /dev/null +++ b/quest/m0/ci/nix-cache-5xx.md @@ -0,0 +1,26 @@ +# [S] A nix.moq.dev error does not fail a check + +## Goal + +A transient 5xx from `nix.moq.dev` costs a cache miss, not a failed +`just ci`: the dev shell still evaluates and builds what it could not +substitute. + +## Plan + +Decided 2026-10-31 (user, /quest-plan of the follow-ups from moq-dev/quest's host-gate cutover for moq.pro and rust2 and its fixer repairs). + +- On 2026-10-31 one HTTP 500 for a `.narinfo` failed `check flake` and + ejected a seven-PR batch in the host land gate. Nix stops on a failed + path-info lookup even with `fallback = true`, which covers only failed + downloads. +- Prefer fixing it at the source: find what made the cache Worker return 500 + for a lookup and have it answer 404 (a miss) when its bucket read fails. + If Nix still sees 5xx from the edge, retry the lookup in the Worker or + through Nix's `download-attempts`. +- The [Nix cache verification](/quest/m0/ci/nix-cache-verify.md) owns the + release side of the cache. + +## Related + +- [Verify the Nix cache](/quest/m0/ci/nix-cache-verify.md) - releases and bucket sizes