diff --git a/AGENTS.md b/AGENTS.md index 8d2911a6f..35e763403 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -72,6 +72,25 @@ stacks should use `stack` and live at `stacks//stack.ncl`. Current stacks cover: aeneas, bun, cabal, cmake, deno, go, gradle, make, maven, meson, npm, ocaml, odin, pip, pnpm, pulumi-go, pulumi-nodejs, rust, shell, stack, uv, zig. +### Tests + +`tests//` holds checks that exercise packages the way users get them, across +several packages at once. A single package's checks stay in that package's `tests` +block. Each directory under `tests/`: + + * is a self-contained min project: its own `minimal.toml`, with `[upstream]` pinning + `gominimal/pkgs` (`locked_commit`) and `[tasks]` to run. It is not a package or a + stack, nothing imports it, and the package checks never evaluate it; + * tests the commit its pin names, never the checkout it sits in. `min update` re-pins + it to main, or `[upstream]` can point at a PR head; + * has a README saying how to run it, what each result means, and who acts on a + failure; + * holds no secrets or private keys. Captured data (certificates, fixtures) is public, + pinned by checksum, and cites its source; + * has no `profiles/` subdirectory, because min reserves `profiles//profile.ncl`. + +Current tests: `tls-trust` (every TLS client refuses a distrusted CA, per distrust response). + ## Package declarations diff --git a/tests/tls-trust/README.md b/tests/tls-trust/README.md new file mode 100644 index 000000000..146421e71 --- /dev/null +++ b/tests/tls-trust/README.md @@ -0,0 +1,243 @@ +# tests/tls-trust + +Checks that every TLS client we ship refuses a distrusted CA. It runs once per response, +and again every week as a regression check. + +Each check runs in a min box, built from the packages users actually get. This directory +has its own `minimal.toml`, and its `[upstream]` pins `gominimal/pkgs`. The clients come +from that commit, the same way a user's project gets them. They do not come from the +checkout this file sits in. + +``` +tests/tls-trust/ + minimal.toml [upstream] pin + 6 tasks (live / offline x 3 package sets) + run.sh entry point: --mode live|offline --profile ... + lib/common.sh timeouts, classifiers, openssl-verify helpers, JSON + lib/c-clients.sh curl, wget, openssl, gnutls-cli (+certtool), git + lib/python.sh python3 urllib, pip + lib/httpie.sh httpie + lib/js.sh + probe.mjs node, node --use-system-ca, bun, deno (one probe for all) + lib/java.sh + Probe.java the JDK on PATH + lib/go.sh + probe.go go + lib/rust.sh uv, uv with UV_SYSTEM_CERTS=1 + lib/controls.sh SELFTEST and NEGCONTROL + responses// one directory per response (the "profile") + targets.txt hosts that must be refused: