x.executor tools

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

check_no_async_dependency.sh

Checks the standalone dependency rule:

• no V source under vlib/x/executor may contain import x.async;
• examples may not mention or use x.async;
• no V source file in the module may be named as an async bridge.

From the repository root:

sh vlib/x/executor/tools/check_no_async_dependency.sh

validate.sh

Runs the guarded validation path:

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

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

From the repository root:

sh vlib/x/executor/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.