x.async tools

This folder contains local helper scripts for safe validation of x.async. Scripts must use repository-relative paths and must not depend on local machine paths, secrets, or external services.

validate.sh

Runs the guarded validation path:

• ./v fmt -verify for module, tests, examples, and benchmarks V files.
• each public example under vlib/x/async/examples/, run serially.
• ./v test vlib/x/async.
• ./v -prod test vlib/x/async.

The script creates a fresh temporary root, sets isolated VTMP and VCACHE, uses the repository-local ./v, and runs commands serially. This avoids the known class of V runner artefact/cache collisions that can happen when multiple external runners share the same checkout/cache.

From the repository root:

sh vlib/x/async/tools/validate.sh

If a crash appears through this serialized and isolated path, treat it as a blocking runtime/test signal. Do not classify it as tooling noise without a new investigation.